فصل ۱ — شروع 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طراحی API کتابخانه TS: خروجی و d.ts
کتابخانه TS خوب: خروجی تایپدار، tree-shakable، JSDoc — مصرفکننده تجربه IDE خوب میگیرد.
مراحل قدمبهقدم
-
۱
خروجی
tsc با declaration: true و d.ts در dist؛ package.json: types: "./dist/index.d.ts" و exports map — مصرفکننده autocomplete کامل.
-
۲
tree-shaking
exportهای named با side-effect-free (sideEffects: false در package.json)؛ barrel index با named exports نه default بزرگ — مصرف خاص، بسته کوچک.
-
۳
JSDoc
توابع عمومی با /** توضیح فارسی */ و @example — hover در IDE راهنما؛ API مستند = انتقال دانش بدون دیاگرام.
-
۴
قراردادهای خطا
برگشت Result یا throw با کلاس خطا؟ توصیه: throw برای برنامهنویس (bug)، Result برای خطای عملیاتی (شبکه) — مستند و یکدست.
نکات مهم
- ◆ declaration: true و types path در package.json.
- ◆ named exports و sideEffects: false برای tree-shaking.
- ◆ JSDoc فارسی از اول؛ hover شما سند است.
کد یا مسیر نمونه
{
"name": "radikal-utils",
"types": "./dist/index.d.ts",
"exports": { ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" } },
"sideEffects": false
}
/**
* تبدیل ارقام فارسی به لاتین
* @example faToEn("۱۲۳") === "123"
*/
export function faToEn(s: string): string { /* … */ }
پرسش و پاسخ این درس (۰)
هنوز دیدگاهی ثبت نشده؛ اولین نفر باشید!