بتل کد Battle Codeدارد باز می‌شود…

جلسه‌ی 6: ورودی‌های نوع‌دار Typed Inputs

به ورودی‌های تابع و به جوابی که برمی‌گرداند نوع می‌دهی. از این به بعد اگر کسی به تابعت متن بدهد، ورودی جا بیندازد یا جواب اشتباهی برگرداند، قبل از اجرا خط قرمز می‌بیند.

در این جلسه یاد می‌گیری

درس

رضا در جاوااسکریپت یک تابع جمع نوشته است: function add(a, b) { return a + b; }. بعد عددی را که کاربر تایپ کرده به آن می‌دهد: add("10", 5). جواب باید ۱۵ باشد، ولی می‌شود 105. باز هم همان اشتباه بی‌صدا: "10" متن است و تابع بی‌خبر آن را به ۵ چسبانده. تابع هیچ راهی ندارد که بگوید «به من فقط عدد بده».

همان تابع را در تایپ‌اسکریپت بگذاریم. اجرا کن: حتی قبل از این‌که کسی صدایش بزند، خط قرمز می‌گیرد. تایپ‌اسکریپت می‌گوید «نوع ورودی a را ننوشته‌ای». چرا این‌قدر سخت‌گیر است؟ چون ورودیِ بدون نوع یعنی «هر چیزی»، یعنی همان any که در این دوره خاموش است. تابعی که هر چیزی می‌گیرد، هیچ اشتباهی را نمی‌گیرد.

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
#out { direction: ltr; text-align: left; font: 16px monospace; margin: 12px 0; padding: 12px; min-height: 28px; border-radius: 12px; background: #0f172a; color: #e2e8f0; white-space: pre-wrap; overflow-wrap: anywhere; }
#out .line { min-height: 22px; }
</style>

<pre id="out"></pre>

<script type="text/typescript">
function add(a, b) {
  return a + b;
}
show(add(10, 5));
</script>

نوع ورودی را مثل نوع جعبه می‌نویسی: بعد از اسمش یک : و بعد نوع. function add(a: number, b: number) یعنی «این تابع دو ورودی می‌گیرد و هر دو باید عدد باشند». هر ورودی نوع خودش را می‌خواهد، حتی اگر نوع‌ها یکی باشند. اجرا کن: 15.

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
#out { direction: ltr; text-align: left; font: 16px monospace; margin: 12px 0; padding: 12px; min-height: 28px; border-radius: 12px; background: #0f172a; color: #e2e8f0; white-space: pre-wrap; overflow-wrap: anywhere; }
#out .line { min-height: 22px; }
</style>

<pre id="out"></pre>

<script type="text/typescript">
function add(a: number, b: number) {
  return a + b;
}
show(add(10, 5));
</script>

حالا اشتباه رضا را تکرار کن: به تابع متن بده. برنامه اجرا نمی‌شود و خط قرمز دقیقاً زیر "10" می‌آید: «این ورودی باید number باشد، ولی string فرستاده‌ای». فرق بزرگ این‌جاست: اشتباه در جایی که تابع را صدا زده‌ای پیدا می‌شود، نه سه صفحه بعد که یک عدد عجیب روی صفحه می‌بینی.

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
#out { direction: ltr; text-align: left; font: 16px monospace; margin: 12px 0; padding: 12px; min-height: 28px; border-radius: 12px; background: #0f172a; color: #e2e8f0; white-space: pre-wrap; overflow-wrap: anywhere; }
#out .line { min-height: 22px; }
</style>

<pre id="out"></pre>

<script type="text/typescript">
function add(a: number, b: number) {
  return a + b;
}
show(add("10", 5));
</script>

تابع فقط ورودی ندارد، جواب هم دارد: چیزی که با return برمی‌گرداند. نوع جواب را بعد از پرانتزِ بسته می‌نویسی: function label(name: string, mark: number): string. آن : string آخر یعنی «این تابع همیشه متن برمی‌گرداند». حالا هر کس خط اول تابع را بخواند، بدون خواندن بقیه‌اش می‌داند چه می‌گیرد و چه می‌دهد.

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
#out { direction: ltr; text-align: left; font: 16px monospace; margin: 12px 0; padding: 12px; min-height: 28px; border-radius: 12px; background: #0f172a; color: #e2e8f0; white-space: pre-wrap; overflow-wrap: anywhere; }
#out .line { min-height: 22px; }
</style>

<pre id="out"></pre>

<script type="text/typescript">
function label(name: string, mark: number): string {
  return name + ": " + mark;
}
const line: string = label("Sara", 18);
show(line);
</script>

نوع جواب از خودت هم مراقبت می‌کند. این تابع قول داده عدد برگرداند (: number)، ولی نویسنده‌اش حواسش نبوده و یک متن ساخته است. اجرا کن: خط قرمز روی return می‌آید، داخل خود تابع. اگر نوع جواب را ننوشته بودی، تایپ‌اسکریپت بی‌صدا فکر می‌کرد «خب، این تابع متن می‌دهد» و اشتباه جای دیگری سر درمی‌آورد.

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
#out { direction: ltr; text-align: left; font: 16px monospace; margin: 12px 0; padding: 12px; min-height: 28px; border-radius: 12px; background: #0f172a; color: #e2e8f0; white-space: pre-wrap; overflow-wrap: anywhere; }
#out .line { min-height: 22px; }
</style>

<pre id="out"></pre>

<script type="text/typescript">
function total(price: number, count: number): number {
  return price + " x " + count;
}
show(total(20, 3));
</script>

تعداد ورودی‌ها هم بررسی می‌شود. در جاوااسکریپت add(10) اجرا می‌شود و جوابش NaN است، چون b خالی مانده. در تایپ‌اسکریپت همین خط قرمز است: «این تابع ۲ ورودی می‌خواهد، ولی ۱ ورودی داده‌ای». ورودی اضافه هم همین‌طور: add(10, 5, 1) قبول نمی‌شود.

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
#out { direction: ltr; text-align: left; font: 16px monospace; margin: 12px 0; padding: 12px; min-height: 28px; border-radius: 12px; background: #0f172a; color: #e2e8f0; white-space: pre-wrap; overflow-wrap: anywhere; }
#out .line { min-height: 22px; }
</style>

<pre id="out"></pre>

<script type="text/typescript">
function add(a: number, b: number): number {
  return a + b;
}
show(add(10));
</script>

تابع فلشی هم همین قانون را دارد: const double = (n: number): number => n * 2;. نوع ورودی داخل پرانتز است و نوع جواب بعد از پرانتز، قبل از =>. اشتباه رایج: نوشتن نوع فقط برای ورودی آخر، مثل (a, b: number). این‌جا a هنوز نوع ندارد و خط قرمز می‌گیرد.

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
#out { direction: ltr; text-align: left; font: 16px monospace; margin: 12px 0; padding: 12px; min-height: 28px; border-radius: 12px; background: #0f172a; color: #e2e8f0; white-space: pre-wrap; overflow-wrap: anywhere; }
#out .line { min-height: 22px; }
</style>

<pre id="out"></pre>

<script type="text/typescript">
const double = (n: number): number => n * 2;
show(double(21));
</script>

مثال‌های این جلسه

چالش‌ها

  1. Type the Inputs (آسان)
  2. Fix the Call (آسان)
  3. Promise an Answer (متوسط)
  4. Full Name (متوسط)
  5. Find the Red Lines (سخت)
  6. Cinema Tickets (سخت)

بیشتر بخوان

← جلسه‌ی 5: پروژه: امتیازشماری که غلط جمع می‌زند جلسه‌ی 7: ورودیِ شاید →