جلسهی 40: پروژه: کوییز روز، با تایپاسکریپت Project: Quiz of the Day, Moved to TypeScript
آخرین پروژهی دوره: یک کوییز کوچک جاوااسکریپتی را در چهار قدم به تایپاسکریپت میآوری. نوعها یک باگ قدیمی را پیدا میکنند، تابعها قول میدهند چه برمیگردانند، و رکورد در حافظه میماند.
در این جلسه یاد میگیری
- در پایان این پروژه میتوانی یک برنامهی کامل جاوااسکریپت را قدمبهقدم به تایپاسکریپت بیاوری.
- در پایان این پروژه میتوانی دادههای برنامه را با
interfaceمدل کنی و باگ پنهان را با آن پیدا کنی. - در پایان این پروژه میتوانی منطق برنامه را در تابعهای کوچک با نوع ورودی و خروجی بنویسی.
- در پایان این پروژه میتوانی یک مقدار را با
salam.saveوsalam.load<T>نگه داری.
درس
مینا پارسال با جاوااسکریپت یک «کوییز روز» ساخته است: سه سؤال، هر سؤال سه جواب، و یک امتیاز. اجرایش کن و بازی کن (جوابها: 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. کوییز خودت را هم فراموش نکن: سؤالهای تازه اضافه کن و به دوستانت نشان بده!
مثالهای این جلسه
چالشها
- Step 1: Bring It In (آسان)
- Step 2: A Shape for a Question (متوسط)
- Step 3: Functions That Promise (متوسط)
- Step 4: The Best Score Stays (سخت)