TypeScript Tutorial فصل ۵ — ابزارهای پیشرفته درس آموزشی

کار با API: fetch، async و نوع پاسخ

async/await در TS همان JS است به‌علاوه چک دقیق: Promise<string> یعنی تابع وعده‌ی یک رشته را می‌دهد. چون پاسخ fetch به‌صورت any می‌آید، شما اینترفیس می‌سازید و با تبدیل امن، بقیه کد با داده تایپ‌شده کار می‌کند — خطای فیلد غلط قبل از اجرا دیده می‌شود.

مراحل قدم‌به‌قدم

  1. ۱

    تعریف تابع async

    async function loadUser(): Promise<User> { … } خروجی هر async تابع همیشه Promise است؛ نوع داخلی Promise را اعلام کنید تا فراخواننده بداند بعد از await چه می‌گیرد.

  2. ۲

    اینترفیس پاسخ API

    interface User { id: number; name: string; } بعد از await res.json() مقدار any است؛ با تبدیل as User (یا اعتبارسنجی بهتر) به TS می‌گویید شکل داده چیست و بقیه کد چک می‌شود.

  3. ۳

    مدیریت خطا

    fetch خودش خطای HTTP را throw نمی‌کند؛ res.ok را چک کنید و در catch خطا را مدیریت کنید. چون catch همیشه unknown می‌دهد، typeof چک کنید و پیام امن بسازید.

  4. ۴

    الگوی کامل

    ترتیب درست: ساخت URL ← چک res.ok ← await res.json() ← تبدیل امن ← استفاده. خطاهای شبکه و HTTP را دو مسیر جدا ببینید.

نکات مهم

  • ◆ داخل تابع async از try/catch استفاده کنید یا خطا را به بالا ارسال کنید.
  • ◆ as User فقط وقتی به شکل پاسخ اعتماد دارید؛ در غیر این صورت اعتبارسنجی کنید.
  • ◆ خروجی res.json() همیشه any است — اعلام اینترفیس وظیفه شماست.

کد یا مسیر نمونه

interface User {
  id: number;
  name: string;
}

async function loadUser(id: number): Promise<User> {
  const res = await fetch(`https://jsonplaceholder.typicode.com/users/${id}`);
  if (!res.ok) throw new Error(`خطای HTTP: ${res.status}`);
  const data = (await res.json()) as User;
  return data;
}

loadUser(1)
  .then((user) => console.log(`کاربر: ${user.name} (#${user.id})`))
  .catch((err: unknown) => {
    if (err instanceof Error) console.error("خطا:", err.message);
    else console.error("خطای ناشناخته", err);
  });

اجرای زنده کد JavaScript

editor.html
در حال آماده‌سازی زمین بازی…

کد را ویرایش کنید و «اجرای کد» را بزنید — خروجی واقعی مرورگر همین‌جا رندر می‌شود؛ مثل آزمایشگاه w3schools.

پرسش و پاسخ این درس (۰)

هنوز دیدگاهی ثبت نشده؛ اولین نفر باشید!

دیدگاه خود را بنویسید

کپچا

دیدگاه شما پس از تأیید مدیر نمایش داده می‌شود.