فصل ۱ — شروع TypeScript
TypeScript چیست و چرا به آن نیاز داریم؟ نصب TypeScript و اجرای اولین فایل tsconfig.json — تنظیمات سختگیرانه پروژهفصل ۲ — انواع داده (Types)
انواع پایه: string، number و boolean any، unknown، void و never — چهار نوع ویژهفصل ۳ — ساختارهای داده و توابع
آرایهها، تاپلها و پیمایش امن Union و Literal Types — «یا» در دنیای نوعها توابع: پارامتر، خروجی و پارامترهای اختیاریفصل ۴ — اینترفیس و کلاس
اینترفیس — قرارداد شکل آبجکتها کلاسها با access modifiers و implementsفصل ۵ — ابزارهای پیشرفته
ژنریکها — توابع و نوعهای پارامتری TypeScript و DOM — چک انواع در مرورگر کار با API: fetch، async و نوع پاسخپروژه عملی پایان دوره
پروژه پایانی ۱ — مدیریت کارها (Todo) تایپشده پروژه پایانی ۲ — داشبورد کاربران با داده واقعی APIکار با API: fetch، async و نوع پاسخ
async/await در TS همان JS است بهعلاوه چک دقیق: Promise<string> یعنی تابع وعدهی یک رشته را میدهد. چون پاسخ fetch بهصورت any میآید، شما اینترفیس میسازید و با تبدیل امن، بقیه کد با داده تایپشده کار میکند — خطای فیلد غلط قبل از اجرا دیده میشود.
مراحل قدمبهقدم
-
۱
تعریف تابع async
async function loadUser(): Promise<User> { … } خروجی هر async تابع همیشه Promise است؛ نوع داخلی Promise را اعلام کنید تا فراخواننده بداند بعد از await چه میگیرد.
-
۲
اینترفیس پاسخ API
interface User { id: number; name: string; } بعد از await res.json() مقدار any است؛ با تبدیل as User (یا اعتبارسنجی بهتر) به TS میگویید شکل داده چیست و بقیه کد چک میشود.
-
۳
مدیریت خطا
fetch خودش خطای HTTP را throw نمیکند؛ res.ok را چک کنید و در catch خطا را مدیریت کنید. چون catch همیشه unknown میدهد، typeof چک کنید و پیام امن بسازید.
-
۴
الگوی کامل
ترتیب درست: ساخت 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
کد را ویرایش کنید و «اجرای کد» را بزنید — خروجی واقعی مرورگر همینجا رندر میشود؛ مثل آزمایشگاه w3schools.
پرسش و پاسخ این درس (۰)
هنوز دیدگاهی ثبت نشده؛ اولین نفر باشید!