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

جلسه‌ی 38: اسباب‌کشی، قدم دوم Moving In, Step Two

بعد از تابع‌ها نوبت داده‌هاست. برای هر «چیزِ» برنامه یک interface می‌سازی و برای حالت‌هایش یک union، تا شیء‌های شل و متن‌های جادویی دیگر جایی برای باگ نگذارند.

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

درس

مینا یک فهرست کار دارد. سه کار، و باید بشمارد چندتا تمام شده‌اند. برنامه را اجرا کن: می‌نویسد Done: 1، ولی دو کار تمام شده! اسم کار سوم هم undefined است. دو غلط تایپی هست: "Done" با D بزرگ و titel به‌جای title. بدتر این‌که تایپ‌اسکریپت هم هیچ خط قرمزی نمی‌دهد. چرا؟ چون هیچ‌جا نگفته‌ایم یک «کار» چه شکلی باید باشد. به این شیء‌ها می‌گوییم شیء شل، و به "done" که هر جا دوباره تایپ می‌شود متن جادویی.

<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 tasks = [
  { title: "Math", state: "done" },
  { title: "Art", state: "Done" },
  { titel: "Music", state: "todo" },
];

let done = 0;
for (const t of tasks) {
  if (t.state === "done") {
    done = done + 1;
  }
}
show("Done: " + done);
show(tasks[2].title);
</script>

قدم اول: برای این «چیز» یک اسم و یک شکل بساز. interface Task می‌گوید هر کار یک title و یک state دارد. بعد به فهرست می‌گوییم Task[]. اجرا کن: titel فوراً خط قرمز می‌گیرد. یک باگ پیدا شد! ولی "Done" هنوز رد می‌شود، چون state یک 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">
interface Task {
  title: string;
  state: string;
}

const tasks: Task[] = [
  { title: "Math", state: "done" },
  { title: "Art", state: "Done" },
  { titel: "Music", state: "todo" },
];
show(tasks.length);
</script>

قدم دوم: حالت‌ها را هم اسم‌دار کن. یک کار فقط سه حالت دارد، پس string خیلی گشاد است. type TaskState = "todo" | "doing" | "done"; و بعد state: TaskState. حالا "Done" هم خط قرمز می‌گیرد، و خط قرمز حتی می‌پرسد: «منظورت done بود؟». متن جادویی تمام شد: حالت‌ها فقط یک جا نوشته شده‌اند.

<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">
type TaskState = "todo" | "doing" | "done";

interface Task {
  title: string;
  state: TaskState;
}

const tasks: Task[] = [
  { title: "Math", state: "done" },
  { title: "Art", state: "Done" },
  { title: "Music", state: "todo" },
];
show(tasks.length);
</script>

هر دو غلط درست شد و برنامه بالاخره راست می‌گوید: Done: 2. حالا تابع‌ها هم می‌توانند از این شکل استفاده کنند: isDone(task: Task). داخل تابع، ویرایشگر می‌داند task چه فیلدهایی دارد، و اگر بنویسی task.state === "finished" خط قرمز می‌گیری، چون چنین حالتی وجود ندارد.

<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">
type TaskState = "todo" | "doing" | "done";

interface Task {
  title: string;
  state: TaskState;
}

const tasks: Task[] = [
  { title: "Math", state: "done" },
  { title: "Art", state: "done" },
  { title: "Music", state: "todo" },
];

function isDone(task: Task): boolean {
  return task.state === "done";
}

show("Done: " + tasks.filter(isDone).length);
show(tasks[2].title);
</script>

چطور «چیزها» را پیدا کنی؟ برنامه را در یک جمله بگو و اسم‌ها را جدا کن. «کتابخانه به هر عضو چند کتاب امانت می‌دهد.» پس Member و Book داریم: دو interface. بعد بپرس هر چیز چه حالت‌هایی دارد: کتاب یا آزاد است یا امانت. پس type BookState = "free" | "borrowed";. هر جا در کد قدیمی یک متن چند بار تکرار شده ("free"، "admin"، "open")، آن‌جا یک union پنهان است.

برای هر حالت یک برچسب می‌خواهی؟ به‌جای چند if پشت سر هم، از Record استفاده کن (جلسه‌ی ۲۹). Record<TaskState, 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">
type TaskState = "todo" | "doing" | "done";

interface Task {
  title: string;
  state: TaskState;
}

const LABELS: Record<TaskState, string> = {
  todo: "To do",
  doing: "In progress",
  done: "Finished",
};

const task: Task = { title: "Math", state: "todo" };
show(task.title + ": " + LABELS[task.state]);
task.state = "doing";
show(task.title + ": " + LABELS[task.state]);
</script>

سه اشتباه رایج در مدل‌سازی. یک: همه چیز را string نگذار. سن عدد است، حالت یک union است. دو: فیلد را فقط وقتی با ? اختیاری کن که واقعاً بعضی وقت‌ها نیست، وگرنه غلط تایپی دوباره راه فرار پیدا می‌کند. سه: شکل را دو بار ننویس. اگر Task داری، همه جا همان را بنویس، نه دوباره { title: string; state: string }.

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

چالش‌ها

  1. Two Pets (آسان)
  2. Name the Thing (آسان)
  3. No More Magic Strings (متوسط)
  4. The Shop Sells Too Much (متوسط)
  5. Find the Red Lines (سخت)
  6. The Little Library (سخت)

بیشتر بخوان

← جلسه‌ی 37: اسباب‌کشی، قدم اول جلسه‌ی 39: حافظه، با نوع →