فصل ۱ — شروع TypeScript

TypeScript چیست و چرا به آن نیاز داریم؟ نصب TypeScript و اجرای اولین فایل tsconfig.json — تنظیمات سخت‌گیرانه پروژه چرا strict؟ فلسفه تایپ‌سیفتی در عمل ابزارها: tsc، ts-node/tsx و ESLint استنتاج نوع: جایی که TS خودش فهم می‌داند readonly و immutability: داده‌های تغییر‌ناپذیر

فصل ۲ — انواع داده (Types)

انواع پایه: string، number و boolean any، unknown، void و never — چهار نوع ویژه

فصل ۳ — ساختارهای داده و توابع

آرایه‌ها، تاپل‌ها و پیمایش امن Union و Literal Types — «یا» در دنیای نوع‌ها توابع: پارامتر، خروجی و پارامترهای اختیاری

فصل ۴ — اینترفیس و کلاس

اینترفیس — قرارداد شکل آبجکت‌ها کلاس‌ها با access modifiers و implements کلاس در عمق: modifiers، ایندکس و builder الگوهای OOP با TS: factory و strategy Decoratorها: annotations با خوانایی

فصل ۵ — ابزارهای پیشرفته

ژنریک‌ها — توابع و نوع‌های پارامتری TypeScript و DOM — چک انواع در مرورگر کار با API: fetch، async و نوع پاسخ

فصل ۲ — انواع داده

type و interface: آبجکت‌ها را درست توصیف کنید Enum در برابر union literal و const object Type Guards: تنگ کردن نوع در runtime ژنریک‌ها: نوع پارامتری

فصل ۳ — ساختارهای داده

Utility Types: Partial، Pick، Omit و دوستان تنگ‌کردن نوع: از union به شکل امن Mapped Types و template literal types declaration merging و .d.ts تاپل‌ها، rest params و overloads conditional types و infer Records و Map تایپ‌دار: دیکشنری امن

فصل ۵ — async و مرورگر

async/await با تایپ: Promise و Result DOM تایپ‌دار: querySelector، رویدادها و forms localStorage/sessionStorage تایپ‌دار wrapper fetch حرفه‌ای: timeout، retry و تایپ طراحی خطای تایپ‌دار: HttpError و Result فرم‌های تایپ‌دار: از schema تا submit فارسی و i18n در TS: اعداد، تاریخ و plural ژنریک پیشرفته: constraints و defaults در عمل

فصل ۶ — پروژه‌های عملی

سازمان‌دهی ماژول‌ها و barrelها پکیج مشترک types بین فرانت و بک دیباگ TS: source map و breakpooint مهاجرت به strict: از JS یا TS شل TS با کد قدیمی JS: integration مرحله‌ای پروژه جامع: داشبورد تایپ‌دار از صفر پروژه TS با Vite: ساختار و env TS با React: props، state و hooks تایپ‌دار TS با Express: request تایپ‌دار و req.user تست TS با Vitest و تایپ‌های mock طراحی API کتابخانه TS: خروجی و d.ts

پروژه عملی پایان دوره

پروژه پایانی ۱ — مدیریت کارها (Todo) تایپ‌شده پروژه پایانی ۲ — داشبورد کاربران با داده واقعی API
TypeScript Tutorial فصل ۵ — async و مرورگر درس آموزشی

طراحی خطای تایپ‌دار: HttpError و Result

خطا با type نه exception پراکنده؛ کلاس‌های خطای دامنه، الگوی Result و mapping خطا به UI — کیفیت لایه شبکه را بالا می‌برد.

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

  1. ۱

    کلاس‌های خطا

    class NotFoundError extends Error { constructor(public resource: string) } — instanceof در catch؛ نام معنادار بهتر از stringهای جادویی.

  2. ۲

    Result

    type Result<T> = { ok: true; data: T } | { ok: false; error: AppError }؛ تابع‌های شبکه Result برمی‌گردانند؛ UI بدون try/catch، خطا render می‌کند.

  3. ۳

    mapping به UI

    AppError با code (network/notfound/auth) — UI پیام فارسی با map code→message؛ کد انگلیسی، پیام فارسی — استاندارد پروژه‌های دو‌زبانه.

  4. ۴

    toast مرکزی

    خطاهای handling‌نشده به توست مرکزی و گزارش تلگرافی؛ هم‌زمان state محلی برای فیلدها — خطا یک‌بار تعریف، چند‌جا مصرف.

نکات مهم

  • ◆ exception برای باگ برنامه؛ Result برای خطای عملیاتی.
  • ◆ code خطا انگلیسی ثابت؛ پیام فارسی از map.
  • ◆ خطای handling‌نشده حتماً گزارش شود؛ سکوت = باگ پنهان.

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

type AppError = { code: "network" | "auth" | "notfound"; message: string };
type Result<T> = { ok: true; data: T } | { ok: false; error: AppError };

const MESSAGES: Record<AppError["code"], string> = {
  network: "اتصال برقرار نشد",
  auth: "نشست شما منقضی شده",
  notfound: "موردی یافت نشد",
};
function show(r: Result<string[]>) {
  return r.ok ? r.data.join("، ") : MESSAGES[r.error.code];
}

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

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

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

کپچا

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