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

جلسه‌ی 36: مجموعه‌های اسم‌دار Named Sets

به‌جای عددها و متن‌های «جادویی» که معنی‌شان فقط در ذهن توست، یک مجموعه‌ی اسم‌دار می‌سازی: با enum، با as const یا با همان union که بلدی. آخرش هم می‌بینی پروژه‌های واقعی چطور چند فایل دارند.

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

درس

رضا در بازی‌اش سطح سختی را با عدد نگه می‌دارد: 0 یعنی آسان، 1 یعنی معمولی، 2 یعنی سخت. این را فقط خودش می‌داند! حالا یک نفر می‌نویسد level = 7. نوع number است، پس خط قرمزی نیست. برنامه اجرا می‌شود و بی‌صدا با ۷ مثل «سخت» رفتار می‌کند. به این عددها می‌گویند عدد جادویی: معنی‌شان در کد نیست، در ذهن نویسنده است.

<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">
// 0 = easy, 1 = normal, 2 = hard
let level: number = 1;

function lives(l: number): number {
  if (l === 0) {
    return 5;
  }
  if (l === 1) {
    return 3;
  }
  return 1;
}

show(lives(level));
level = 7;
show(lives(level));
</script>

راه اول: enum. با enum Level { Easy, Normal, Hard } یک مجموعه‌ی اسم‌دار می‌سازی: یک نوع تازه به اسم Level که فقط همین سه عضو را دارد. هر عضو را با نقطه می‌نویسی: Level.Easy. حالا کد خودش می‌گوید منظور چیست، و دیگر لازم نیست یادت بماند 2 یعنی چه. پشت پرده هنوز عدد است: show(Level.Hard) می‌نویسد 2.

<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">
enum Level { Easy, Normal, Hard }

function lives(level: Level): number {
  if (level === Level.Easy) {
    return 5;
  }
  if (level === Level.Normal) {
    return 3;
  }
  return 1;
}

show(lives(Level.Normal));
show(lives(Level.Hard));
show(Level.Hard);
</script>

حالا همان اشتباه را امتحان کن. Level.Medium وجود ندارد، و 7 هم عضو این مجموعه نیست. هر دو خط قرمز می‌گیرند. خط قرمز می‌گوید: «Level چیزی به این اسم ندارد». یعنی اشتباهی که قبلاً بی‌صدا بود، حالا قبل از اجرا پیدا می‌شود.

<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">
enum Level { Easy, Normal, Hard }

let level: Level = Level.Medium;
level = 7;
show(level);
</script>

اگر بخواهی به‌جای عدد، متن پشت هر عضو باشد، خودت مقدار بده: Red = "red". این برای نشان دادن و نگه داشتن خیلی بهتر است، چون red را می‌شود خواند ولی 0 را نه. یک نکته‌ی مهم: interface و type قبل از اجرا پاک می‌شوند، ولی enum می‌ماند. در جاوااسکریپتِ نهایی یک شیء واقعی به اسم Color هست.

<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">
enum Color { Red = "red", Green = "green", Blue = "blue" }

let paint: Color = Color.Green;
show(paint);
show("I like " + Color.Blue);
</script>

راه دوم: as const. این دو کلمه را آخر یک شیء یا آرایه می‌گذاری و می‌گویی: «این ثابت است، همین مقدارها و نه هیچ چیز دیگر». بدون as const، تایپ‌اسکریپت فکر می‌کند tea یک number معمولی است و هر کسی می‌تواند عوضش کند. با as const، همه چیز readonly می‌شود. اجرا کن: خط آخر خط قرمز می‌گیرد، چون منو قفل است.

<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 PRICES = { tea: 5, cake: 12 } as const;

show(PRICES.tea);
PRICES.tea = 0;
</script>

as const یک هنر دیگر هم دارد: می‌شود از روی یک فهرست، نوع ساخت. typeof LEVELS[number] یعنی «نوعِ هر کدام از خانه‌های LEVELS». چون فهرست قفل است، این نوع دقیقاً می‌شود "easy" | "normal" | "hard". فایده‌اش: سطح‌ها را فقط یک جا می‌نویسی. هم می‌توانی روی فهرست حلقه بزنی (مثلاً برای ساختن دکمه‌ها) و هم نوع داری.

<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 LEVELS = ["easy", "normal", "hard"] as const;
type Level = typeof LEVELS[number];

let level: Level = "normal";
for (const l of LEVELS) {
  show(l);
}
show("Now: " + level);
</script>

راه سوم را از جلسه‌ی ۱۷ بلدی: union از مقدارهای دقیق. type Level = "easy" | "normal" | "hard"; همان کار را می‌کند و از همه ساده‌تر است. پس کدام؟ اگر فقط نوع می‌خواهی: union. اگر خودِ فهرست را هم در برنامه لازم داری: as const. و enum را در خیلی از پروژه‌ها می‌بینی، پس باید بتوانی آن را بخوانی. هر سه یک چیز را تضمین می‌کنند: مقدار غلط، خط قرمز می‌گیرد.

<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 Level = "easy" | "normal" | "hard";

let level: Level = "easy";
level = "hard";
show(level);
</script>

یک نگاه به دنیای واقعی. این‌جا همه‌ی کد در یک صفحه است، ولی یک پروژه‌ی واقعی ده‌ها فایل دارد. هر فایل چیزهایی را که بقیه لازم دارند با export بیرون می‌دهد (مثلاً export enum Level)، و فایل دیگر با import آن‌ها را می‌گیرد. یک فایل هم به اسم tsconfig.json هست که قانون‌های پروژه را می‌گوید. مهم‌ترین خطش "strict": true است: همان سخت‌گیری‌ای که در کل این دوره روشن بوده. در این صفحه‌ها import و export کار نمی‌کنند، چون فقط یک فایل داریم. فقط بدان که هستند.

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

چالش‌ها

  1. Which Way? (آسان)
  2. Three Sizes (آسان)
  3. Lock the Menu (متوسط)
  4. One List, One Type (متوسط)
  5. Find the Red Lines (سخت)
  6. Pizza Sizes (سخت)

بیشتر بخوان

← جلسه‌ی 35: پروژه: فرم ثبت‌نام جلسه‌ی 37: اسباب‌کشی، قدم اول →