جلسهی 39: حافظه، با نوع Remember, with Types
با salam.save و salam.load برنامهات بعد از بسته شدن صفحه هم یادش میماند. یاد میگیری به load بگویی چه نوعی میخواهی، و با یک نگهبان نوع مطمئن شوی چیزی که برگشته واقعاً همان است.
در این جلسه یاد میگیری
- در پایان این جلسه میتوانی با
salam.saveیک مقدار را نگه داری و باsalam.load<T>آن را با نوع درست بخوانی. - در پایان این جلسه میدانی مقدار پیشفرض باید با نوعی که خواستهای جور باشد.
- در پایان این جلسه میدانی
load<T>یک قول است و چیزی که از حافظه میآید ممکن است شکل دیگری داشته باشد. - در پایان این جلسه میتوانی با
unknownو یک نگهبان نوع، دادهی نگهداشتهشده را قبل از استفاده بررسی کنی.
درس
این شمارنده را اجرا کن و سه بار دکمه را بزن. حالا دوباره 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 استفاده کنی، تا غلط تایپی راه نداشته باشد. سه: اگر شکل دادهات ممکن است عوض شده باشد، با یک ورودی بخوان و با نگهبان بررسی کن.
مثالهای این جلسه
- مثال JavaScript: <button id="go" onclick="press()">+1</butto… — حافظه، با نوع
- مثال JavaScript: <button id="go" onclick="press()">+1</butto… — حافظه، با نوع 2
- مثال JavaScript: <script type="text/typescript"> — حافظه، با نوع
- مثال JavaScript: <button id="go" onclick="press()">Sound on/…
- مثال JavaScript: <script type="text/typescript"> — حافظه، با نوع 2
- مثال JavaScript: <script type="text/typescript"> — حافظه، با نوع 2 3
- مثال JavaScript: <script type="text/typescript"> — حافظه، با نوع 2 3 4
چالشها
- The Counter Remembers (آسان)
- Hello Again (آسان)
- The Guest List (متوسط)
- Old Data (متوسط)
- Find the Bug (سخت)
- The Safe Profile (سخت)
بیشتر بخوان
← جلسهی 38: اسبابکشی، قدم دوم جلسهی 40: پروژه: کوییز روز، با تایپاسکریپت →