فصل ۱ — شروع 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) تایپشده پروژه پایانی ۲ — داشبورد کاربران با داده واقعی APITS با Express: request تایپدار و req.user
Express + TS با تایپهای express و zod — req تایپدار، req.user سفارشی با declaration merging؛ الگوی API جدی.
مراحل قدمبهقدم
-
۱
پایه
import express و app.get("/x", (req: Request, res: Response) => …)؛ async handler با helper — next در catch.
-
۲
req.user سفارشی
declare global { namespace Express { interface Request { user?: { id: number; role: string } } } } — بعد از middleware auth، req.user تایپدار؛ در types/express.d.ts.
-
۳
zod + body تایپدار
const body = LoginSchema.parse(req.body) — خروجی تایپدار از schema؛ بعد از parse، body امن است (strip extraها) — ورودی API همیشه از schema.
-
۴
خطا تایپدار
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) });
});
پرسش و پاسخ این درس (۰)
هنوز دیدگاهی ثبت نشده؛ اولین نفر باشید!