فصل ۱ — شروع 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 فصل ۶ — پروژه‌های عملی درس آموزشی

TS با Express: request تایپ‌دار و req.user

Express + TS با تایپ‌های express و zod — req تایپ‌دار، req.user سفارشی با declaration merging؛ الگوی API جدی.

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

  1. ۱

    پایه

    import express و app.get("/x", (req: Request, res: Response) => …)؛ async handler با helper — next در catch.

  2. ۲

    req.user سفارشی

    declare global { namespace Express { interface Request { user?: { id: number; role: string } } } } — بعد از middleware auth، req.user تایپ‌دار؛ در types/express.d.ts.

  3. ۳

    zod + body تایپ‌دار

    const body = LoginSchema.parse(req.body) — خروجی تایپ‌دار از schema؛ بعد از parse، body امن است (strip extraها) — ورودی API همیشه از schema.

  4. ۴

    خطا تایپ‌دار

    HttpError با status؛ error handler با instanceof HttpError — پاسخ منظم؛ بدون any در زنجیره خطا.

نکات مهم

  • ◆ req.user را با declaration merging تایپ کنید؛ cast نمی‌خواهد.
  • ◆ zod parse داده را تایپ‌دار و پاک می‌کند.
  • ◆ typecheck را در CI بگذارید؛ Express تایپ‌های ناتمام دارد.

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

// types/express.d.ts
declare global {
  namespace Express {
    interface Request { user?: { id: number; role: "admin" | "user" } }
  }
}

// src/routes.ts
const Login = z.object({ email: z.string().email(), password: z.string().min(8) });
router.post("/login", (req, res) => {
  const body = Login.parse(req.body);       // { email: string; password: string }
  const user = users.byEmail(body.email);
  if (!user) throw new HttpError(401, "نادرست");
  res.json({ token: sign(user) });
});

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

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

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

کپچا

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