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

جلسه‌ی 40: پروژه: کوییز روز، با تایپ‌اسکریپت Project: Quiz of the Day, Moved to TypeScript

آخرین پروژه‌ی دوره: یک کوییز کوچک جاوااسکریپتی را در چهار قدم به تایپ‌اسکریپت می‌آوری. نوع‌ها یک باگ قدیمی را پیدا می‌کنند، تابع‌ها قول می‌دهند چه برمی‌گردانند، و رکورد در حافظه می‌ماند.

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

درس

مینا پارسال با جاوااسکریپت یک «کوییز روز» ساخته است: سه سؤال، هر سؤال سه جواب، و یک امتیاز. اجرایش کن و بازی کن (جواب‌ها: 5، 5 و 9). یک چیز عجیب است: حتی اگر همه را درست بزنی، آخرش می‌نویسد Done! 2 of 3. سؤال سوم هیچ‌وقت درست حساب نمی‌شود! مینا هر چه کد را خوانده، دلیلش را پیدا نکرده است. در این پروژه برنامه را به تایپ‌اسکریپت می‌آوری، و خواهی دید نوع‌ها در چند ثانیه باگ را پیدا می‌کنند.

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
</style>

<p id="msg"></p>
<button id="a" onclick="answer(0)">A</button>
<button id="b" onclick="answer(1)">B</button>
<button id="c" onclick="answer(2)">C</button>
<p id="score">Score: 0</p>
<button id="again" onclick="restart()">Again</button>

<script type="text/typescript">
const questions = [
  { text: "2 + 3", choices: ["4", "5", "6"], answer: 1 },
  { text: "10 / 2", choices: ["5", "2", "20"], answer: 0 },
  { text: "3 * 3", choices: ["6", "33", "9"], answer: "2" },
];
let current = 0;
let score = 0;

function setText(id: string, text: string): void {
  const el = document.getElementById(id);
  if (el) {
    el.textContent = text;
  }
}

function draw(): void {
  setText("score", "Score: " + score);
  if (current >= questions.length) {
    setText("msg", "Done! " + score + " of " + questions.length);
    return;
  }
  const q = questions[current];
  setText("msg", q.text);
  setText("a", q.choices[0]);
  setText("b", q.choices[1]);
  setText("c", q.choices[2]);
}

function answer(choice: number): void {
  if (current >= questions.length) {
    return;
  }
  if (choice === questions[current].answer) {
    score = score + 1;
  }
  current = current + 1;
  draw();
}

function restart(): void {
  current = 0;
  score = 0;
  draw();
}

draw();
</script>

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

پروژه چهار قدم دارد و هر قدم روی کد قدم قبل ساخته می‌شود. قدم ۱: کد جاوااسکریپت را می‌آوری و به ورودی تابع‌ها نوع می‌دهی تا اجرا شود. قدم ۲: برای سؤال یک interface می‌سازی، و باگ پیدا می‌شود. قدم ۳: بررسی جواب و متن نتیجه را در دو تابع با نوع می‌نویسی. قدم ۴: رکورد را در حافظه نگه می‌داری. بعد از هر قدم اجرا کن و یک دور بازی کن.

دو یادآوری از فاز ۷. document.getElementById(id) ممکن است چیزی پیدا نکند و null بدهد. پس قبل از استفاده بپرس: if (el) { ... }. تابع کوچک setText این کار را یک بار انجام می‌دهد و بقیه‌ی برنامه فقط آن را صدا می‌زند. و یادت باشد: دکمه‌ها answer(0)، answer(1) و answer(2) را صدا می‌زنند، پس ورودی answer یک عدد است: شماره‌ی جواب، از صفر.

تبریک! این آخرین کارت دوره است. تو حالا می‌توانی اشتباه را قبل از اجرا بگیری، و این همان کاری است که برنامه‌نویس‌های حرفه‌ای هر روز می‌کنند. قدم بعد چیست؟ ری‌اکت (React): در دوره‌ی ری‌اکت صفحه را از تکه‌های کوچک می‌سازی، و بیشتر پروژه‌های ری‌اکت با تایپ‌اسکریپت نوشته می‌شوند، پس نوع‌هایت آن‌جا خیلی به کار می‌آیند. و اگر دوست داری بدانی داده‌ها در سرور چطور نگه داشته می‌شوند و یک سایت واقعی پشت صحنه چه می‌کند، برو سراغ /learn/backend. کوییز خودت را هم فراموش نکن: سؤال‌های تازه اضافه کن و به دوستانت نشان بده!

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

چالش‌ها

  1. Step 1: Bring It In (آسان)
  2. Step 2: A Shape for a Question (متوسط)
  3. Step 3: Functions That Promise (متوسط)
  4. Step 4: The Best Score Stays (سخت)

بیشتر بخوان

← جلسه‌ی 39: حافظه، با نوع