فصل ۱ — شروع 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 فصل ۳ — ساختارهای داده درس آموزشی

declaration merging و .d.ts

declarationها قرارداد بی‌کد هستند؛ interface merge، module augmentation و تعریف types برای پکیج‌های بدون تایپ — ابزارهای integration TS.

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

  1. ۱

    merging

    دو interface با هم نام، فیلدها جمع می‌شوند؛ کاربرد: extend کردن interface پکیج با فیلد اضافه (window.__APP__ با declare global).

  2. ۲

    declare global

    declare global { interface Window { dataLayer?: unknown[] } } — در فایل env.d.ts پروژه؛ GTM و چیزهای سراسری تایپ می‌گیرند.

  3. ۳

    پکیج بدون تایپ

    نصب @types/pkg اگر باشد؛ اگر نه: declare module "pkg" { export function foo(a: string): number } در types.d.ts — حداقل قرارداد تا any پخش نشود.

  4. ۴

    الگوی env

    interface ImportMetaEnv { readonly VITE_API_URL: string } — env تایپ‌دار در پروژه‌های Vite؛ خطای کلید غلط در کامپایل.

نکات مهم

  • ◆ declare global برای window و بیرونی‌ها؛ در env.d.ts.
  • ◆ قبل از declare module، @types را چک کنید.
  • ◆ env را تایپ کنید؛ تایپ‌پیام‌های خطای زودهنگام ارزش دارد.

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

// src/env.d.ts
/// <reference types="vite/client" />
interface ImportMetaEnv {
  readonly VITE_API_URL: string;
}

declare global {
  interface Window { gtag?: (...args: unknown[]) => void }
}

// پکیج بی‌تایپ:
declare module "legacy-pkg" {
  export function init(el: HTMLElement, opts?: { rtl?: boolean }): void;
}

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

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

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

کپچا

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