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

جلسه‌ی 34: بعداً، با نوع Later, with Types

بعضی جواب‌ها همین حالا آماده نیستند. با Promise<T> به تایپ‌اسکریپت می‌گویی «این مقدار بعداً می‌رسد»، با async و await منتظرش می‌مانی، و یک تابع wait با نوع می‌سازی.

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

درس

مینا می‌خواست تابعش یک ثانیه صبر کند و بعد امتیاز را برگرداند. return را داخل setTimeout گذاشت. در جاوااسکریپت خطایی نمی‌آمد، ولی جواب NaN بود. چرا؟ چون آن return مالِ تابعِ کوچکِ داخل setTimeout است، نه مالِ getScore. خودِ getScore همان لحظه تمام می‌شود و هیچ چیز برنمی‌گرداند. اجرا کن: تایپ‌اسکریپت می‌گوید این تابع قول داده عدد برگرداند، ولی return ندارد.

<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">
function getScore(): number {
  setTimeout(() => {
    return 12;
  }, 1000);
}

show(getScore() + 1);
</script>

چیزی که بعداً آماده می‌شود را نمی‌شود همین حالا برگرداند. به‌جایش یک جعبه‌ی قول برمی‌گردانیم: Promise. نوعش Promise<number> است، یعنی «یک عدد، ولی بعداً». (این همان شکلِ جنریکِ جلسه‌ی ۲۸ است.) داخل جعبه، هر وقت جواب آماده شد، resolve(12) را صدا می‌زنیم. بیرون، .then(...) می‌گوید «وقتی رسید، این کار را بکن». اجرا کن و یک ثانیه صبر کن.

<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">
function getScore(): Promise<number> {
  return new Promise((resolve) => {
    setTimeout(() => {
      resolve(12);
    }, 1000);
  });
}

getScore().then((score) => {
  show(score + 1);
});
</script>

اشتباه رایج: یادت برود که جواب هنوز داخل جعبه است. این‌جا جوابِ getScore() را مستقیم در یک جعبه‌ی عددی گذاشته‌ایم. اجرا کن: خط قرمز! Promise<number> خودش number نیست. جعبه‌ی قول را نمی‌شود با ۱ جمع کرد؛ اول باید بازش کنی. در جاوااسکریپت همین کد بی‌صدا می‌نوشت [object Promise]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">
function getScore(): Promise<number> {
  return new Promise((resolve) => {
    setTimeout(() => {
      resolve(12);
    }, 1000);
  });
}

const score: number = getScore();
show(score + 1);
</script>

راه راحتِ باز کردن جعبه await است: const score = await getScore(); یعنی «صبر کن تا برسد، بعد مقدارش را بده». حالا score یک number واقعی است. دو قانون: await فقط داخل تابعی کار می‌کند که اولش async نوشته شده. و تابع async خودش هم «بعداً» تمام می‌شود، پس نوع خروجی‌اش همیشه یک Promise است: این‌جا Promise<void>، چون چیزی برنمی‌گرداند. اگر بنویسی : void، خط قرمز می‌گیری.

<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">
function getScore(): Promise<number> {
  return new Promise((resolve) => {
    setTimeout(() => {
      resolve(12);
    }, 1000);
  });
}

async function main(): Promise<void> {
  const score = await getScore();
  show(score + 1);
}

main();
</script>

پرکاربردترین تابع این جلسه: wait. ورودی‌اش ms: number است (هزارم ثانیه) و خروجی‌اش Promise<void>: قولی که هیچ مقداری ندارد و فقط می‌گوید «تمام شد». داخلش setTimeout بعد از ms خودِ resolve را صدا می‌زند. حالا می‌شود نوشت await wait(1000); و برنامه همان‌جا یک ثانیه می‌ماند. اجرا کن.

<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">
function wait(ms: number): Promise<void> {
  return new Promise((resolve) => {
    setTimeout(resolve, ms);
  });
}

async function main(): Promise<void> {
  show("Ready");
  await wait(1000);
  show("Go!");
}

main();
</script>

تابع async می‌تواند مقدار هم برگرداند. داخلش ساده می‌نویسی return n * 2; و تایپ‌اسکریپت خودش آن را در جعبه‌ی قول می‌گذارد. پس نوع خروجی Promise<number> است، نه number. هر کس double را صدا بزند، باید با await جعبه را باز کند.

<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">
function wait(ms: number): Promise<void> {
  return new Promise((resolve) => {
    setTimeout(resolve, ms);
  });
}

async function double(n: number): Promise<number> {
  await wait(500);
  return n * 2;
}

async function main(): Promise<void> {
  const result = await double(4);
  show(result);
}

main();
</script>

اگر await یادت برود چه؟ این‌جا double(4) بدون await صدا زده شده، پس result هنوز یک جعبه‌ی قول است. اجرا کن: تایپ‌اسکریپت می‌گوید جمعِ Promise<number> با عدد معنی ندارد. ولی مواظب باش: تایپ‌اسکریپت همیشه نمی‌تواند کمک کند. اگر فقط بنویسی wait(1000); بدون await، خط قرمزی نمی‌آید و برنامه صبر نمی‌کند.

<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">
function wait(ms: number): Promise<void> {
  return new Promise((resolve) => {
    setTimeout(resolve, ms);
  });
}

async function double(n: number): Promise<number> {
  await wait(500);
  return n * 2;
}

async function main(): Promise<void> {
  const result = double(4);
  show(result + 1);
}

main();
</script>

روی صفحه هم همین است. تابعِ دکمه می‌تواند async باشد: async function press(): Promise<void>. دکمه را بزن: اول پیام Wait... می‌آید، دو ثانیه بعد لامپ روشن می‌شود. یک نکته: این‌جا await را بیرون از تابع ننویس؛ همیشه آن را داخل یک تابع async بگذار، مثل main یا press.

<style>
body { font-family: sans-serif; text-align: center; padding: 16px; }
button, input, select { font-size: 16px; min-height: 40px; margin: 4px; }
.lamp { font-size: 80px; width: 130px; margin: 12px auto; border-radius: 24px; background: #334155; filter: grayscale(1); opacity: 0.5; }
.lamp.on { background: #fde047; filter: none; opacity: 1; }
</style>

<div id="lamp" class="lamp">💡</div>
<button id="go" onclick="press()">On in 2 seconds</button>
<p id="msg"></p>

<script type="text/typescript">
function wait(ms: number): Promise<void> {
  return new Promise((resolve) => {
    setTimeout(resolve, ms);
  });
}

async function press(): Promise<void> {
  const lamp = document.getElementById("lamp");
  const msg = document.getElementById("msg");
  if (!lamp || !msg) {
    return;
  }
  msg.textContent = "Wait...";
  await wait(2000);
  lamp.classList.add("on");
  msg.textContent = "On";
}
</script>

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

چالش‌ها

  1. Open the Box (آسان)
  2. Types for wait (آسان)
  3. The Slow Lamp (متوسط)
  4. Double, Later (متوسط)
  5. Find the Bug (سخت)
  6. The Traffic Light, On Time (سخت)

بیشتر بخوان

← جلسه‌ی 33: داده از بیرون جلسه‌ی 35: پروژه: فرم ثبت‌نام →