فصل ۱ — شروع 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) تایپشده پروژه پایانی ۲ — داشبورد کاربران با داده واقعی APIDecoratorها: annotations با خوانایی
Decorator تابعی روی کلاس/متد/پراپرتی (TS 5 استاندارد جدید)؛ logging، validation و DI سبک — با احتیاط، چون جادوی پنهان میسازد.
مراحل قدمبهقدم
-
۱
پایه TS 5
function log(target: any, ctx: ClassMethodDecoratorContext) { … }؛ @log روی متد — در runtime پوشش (wrap) میکند؛ استاندارد جدید بهجای legacy experimental.
-
۲
کاربرد logging/validate
@log زمان هر فراخوانی؛ @required برای فیلد؛ در NestJS دیپلوی DI با decorator استاندارد است — اکوسیستم آشنا.
-
۳
method wrap
return async function (...args) { const t0=…; const r = await original.apply(this,args); logTiming(); return r } — بدون تغییر بدنه متد، رفتار میگیرد.
-
۴
مرزها
decorator روی متد ساده؛ منطق پیچیده در helper جدا؛ هر decorator با تست؛ در تیم، فهرست decoratorهای مجاز مستند شود.
نکات مهم
- ◆ TS 5 استاندارد؛ experimentalDecorators قدیمی است.
- ◆ decorator برای logging/validation/DI؛ منطق business نه.
- ◆ هر decorator با تست و مستند.
کد یا مسیر نمونه
function log(target: Function, ctx: ClassMethodDecoratorContext) {
return function (this: any, ...args: unknown[]) {
const t0 = performance.now();
const r = target.apply(this, args);
console.log(`${String(ctx.name)}: ${performance.now() - t0}ms`);
return r;
};
}
class OrderService {
@log
async create(data: unknown) { /* … */ }
}
پرسش و پاسخ این درس (۰)
هنوز دیدگاهی ثبت نشده؛ اولین نفر باشید!