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

جلسه‌ی 39: حافظه، با نوع Remember, with Types

با salam.save و salam.load برنامه‌ات بعد از بسته شدن صفحه هم یادش می‌ماند. یاد می‌گیری به load بگویی چه نوعی می‌خواهی، و با یک نگهبان نوع مطمئن شوی چیزی که برگشته واقعاً همان است.

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

درس

این شمارنده را اجرا کن و سه بار دکمه را بزن. حالا دوباره Run را بزن: برگشت به صفر! برنامه فراموش‌کار است، چون متغیرها با بسته شدن صفحه پاک می‌شوند. در دوره‌ی جاوااسکریپت با salam.save و salam.load این را حل کردی. امروز همان را با نوع می‌نویسیم، و یک مشکل تازه هم می‌بینیم: تایپ‌اسکریپت داخل حافظه را نمی‌بیند. از کجا بداند چیزی که دیروز نگه داشته شده، عدد است یا متن؟

<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>

<button id="go" onclick="press()">+1</button>
<pre id="out"></pre>

<script type="text/typescript">
let count: number = 0;

function press(): void {
  count = count + 1;
  show("Count: " + count);
}

show("Count: " + count);
</script>

salam.save("count", count) مقدار را زیر اسم count نگه می‌دارد. salam.load<number>("count", 0) آن را می‌خواند. آن <number> همان چیزی است که در فاز جنریک‌ها دیدی: می‌گویی «انتظار دارم یک عدد برگردد». 0 هم مقدار پیش‌فرض است، برای بار اول که هنوز چیزی نگه داشته نشده. حالا چند بار دکمه را بزن و دوباره اجرا کن: عدد مانده است.

<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>

<button id="go" onclick="press()">+1</button>
<pre id="out"></pre>

<script type="text/typescript">
let count = salam.load<number>("count", 0);

function press(): void {
  count = count + 1;
  salam.save("count", count);
  show("Count: " + count);
}

show("Count: " + count);
</script>

مقدار پیش‌فرض باید با نوعی که خواسته‌ای جور باشد. اگر گفته‌ای <number> و پیش‌فرض را متن بدهی، خط قرمز می‌گیری. این خوب است: یعنی count همیشه عدد است، چه بار اول باشد چه بار صدم. یک نکته: برای آرایه حتماً نوع را بنویس، مثل salam.load<string[]>("names", [])، چون [] خالی به‌تنهایی نمی‌گوید قرار است چه چیزی در آن باشد.

<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">
let count = salam.load<number>("count", "zero");
show("Count: " + count);
</script>

شیء را هم می‌شود نگه داشت. یک interface برای شکلش بنویس و همان را به load بده: salam.load<Settings>(...). حالا settings.name متن است و settings.sound بله/نه، و ویرایشگر هر دو را می‌شناسد. چه چیزهایی نگه داشته می‌شوند؟ عدد، متن، true/false، آرایه و شیء ساده. تابع‌ها و متدهای یک کلاس نگه داشته نمی‌شوند.

<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>

<button id="go" onclick="press()">Sound on/off</button>
<pre id="out"></pre>

<script type="text/typescript">
interface Settings {
  name: string;
  sound: boolean;
}

const settings = salam.load<Settings>("settings", { name: "friend", sound: true });

function press(): void {
  settings.sound = !settings.sound;
  salam.save("settings", settings);
  show("Sound: " + settings.sound);
}

show("Hello, " + settings.name);
show("Sound: " + settings.sound);
</script>

حالا آن مشکل. load<number> فقط یک قول است، مثل as در جلسه‌ی ۳۱: تایپ‌اسکریپت حرفت را باور می‌کند و بررسی نمی‌کند. فرض کن نسخه‌ی قدیمی برنامه زیر همین اسم، متنِ "3" را نگه داشته باشد. خط اول این برنامه همان کار را می‌کند. اجرا کن: خط قرمزی نیست، ولی جواب 31 است، نه 4! همان باگ بی‌صدای جلسه‌ی اول برگشته، این بار از راه حافظه.

<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">
salam.save("count", "3");

let count = salam.load<number>("count", 0);
show(count + 1);
</script>

راه امن: salam.load را فقط با یک ورودی صدا بزن. آن‌وقت نوع جواب unknown است (جلسه‌ی ۳۳): «نمی‌دانم چیست». و unknown را تا بررسی نکنی، نمی‌شود استفاده کرد. با typeof می‌پرسیم: عدد است؟ اگر بود همان را برمی‌داریم، وگرنه 0. اجرا کن: این بار متن قدیمی کنار گذاشته می‌شود و جواب 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">
salam.save("count", "3");

const raw = salam.load("count");
let count: number = typeof raw === "number" ? raw : 0;
show(count + 1);
</script>

برای یک شیء، بررسی را در یک نگهبان نوع می‌گذاریم (باز هم جلسه‌ی ۳۳): تابعی که خروجی‌اش value is Settings است. داخلش می‌پرسیم: شیء است؟ خالی نیست؟ name دارد و متن است؟ sound دارد و بله/نه است؟ اگر نگهبان گفت بله، تایپ‌اسکریپت از آن‌جا به بعد مطمئن است. اگر نه، مقدار پیش‌فرض را برمی‌داریم. این‌طوری داده‌ی قدیمی یا خراب هیچ‌وقت برنامه را به هم نمی‌ریزد.

<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 Settings {
  name: string;
  sound: boolean;
}

function isSettings(value: unknown): value is Settings {
  return typeof value === "object" && value !== null
    && "name" in value && typeof value.name === "string"
    && "sound" in value && typeof value.sound === "boolean";
}

const raw = salam.load("settings");
const settings: Settings = isSettings(raw) ? raw : { name: "friend", sound: true };
show("Hello, " + settings.name);
</script>

سه قانون برای حافظه. یک: بعد از هر تغییر نگه دار، نه قبل از آن. دو: اسم را در save و load دقیقاً یکی بنویس. بهتر است یک بار بنویسی const KEY = "count"; و همه جا از KEY استفاده کنی، تا غلط تایپی راه نداشته باشد. سه: اگر شکل داده‌ات ممکن است عوض شده باشد، با یک ورودی بخوان و با نگهبان بررسی کن.

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

چالش‌ها

  1. The Counter Remembers (آسان)
  2. Hello Again (آسان)
  3. The Guest List (متوسط)
  4. Old Data (متوسط)
  5. Find the Bug (سخت)
  6. The Safe Profile (سخت)

بیشتر بخوان

← جلسه‌ی 38: اسباب‌کشی، قدم دوم جلسه‌ی 40: پروژه: کوییز روز، با تایپ‌اسکریپت →