فلش‌کارت‌های آموزشی Typescript: استفاده از Property Decorators

📚 کتاب آموزشی جامع

📚 اطلاعات کتاب

عنوان کتاب: کتاب Typescript: استفاده از Property Decorators

موضوع کلی: برنامه نویسی

موضوع میانی: تایپ اسکریپت (TypeScript)

📋 سرفصل‌های کتاب (100 موضوع)

• 1. مقدمه‌ای بر تایپ‌اسکریپت و چرایی استفاده از آن
• 2. راه‌اندازی محیط توسعه (Node.js, TSC)
• 3. پیکربندی `tsconfig.json` برای شروع
• 4. مروری بر انواع داده‌های پایه در تایپ‌اسکریپت
• 5. کلاس‌ها در تایپ‌اسکریپت: سنگ بنای دکوریتورها
• 6. ویژگی‌ها (Properties) و اصلاح‌کننده‌های دسترسی (public, private)
• 7. متدها، Getter و Setter ها در کلاس‌ها
• 8. مفهوم متادیتا (Metadata) چیست؟
• 9. آشنایی با دکوریتورها (Decorators): یک مفهوم سطح بالا
• 10. فعال‌سازی دکوریتورها: `experimentalDecorators`
• 11. فعال‌سازی متادیتا: `emitDecoratorMetadata`
• 12. چهار نوع دکوریتور: کلاس، متد، پارامتر و پراپرتی
• 13. تمرکز دوره: چرا Property Decorators مهم هستند؟
• 14. آناتومی یک Property Decorator: تابع و آرگومان‌های آن
• 15. آرگومان اول: `target` - پروتوتایپ یا سازنده کلاس
• 16. آرگومان دوم: `propertyKey` - نام پراپرتی
• 17. نوشتن اولین Property Decorator: یک مثال `console.log` ساده
• 18. تفاوت دکوریتور روی پراپرتی‌های instance و static
• 19. زمان اجرای دکوریتور: در زمان تعریف کلاس، نه در زمان ساخت نمونه
• 20. محدودیت اصلی Property Decorators: عدم تغییر مستقیم مقدار اولیه
• 21. معرفی Reflect Metadata API
• 22. نصب و راه‌اندازی کتابخانه `reflect-metadata`
• 23. ذخیره کردن متادیتا با `Reflect.defineMetadata`
• 24. بازیابی متادیتا با `Reflect.getMetadata`
• 25. مثال عملی: ساخت یک دکوریتور `@log` برای ثبت اطلاعات
• 26. مشکل لاگ کردن دسترسی: چرا `@log` به تنهایی کافی نیست؟
• 27. راه حل: ترکیب Property Decorator با Getter و Setter
• 28. بازنویسی پراپرتی با `Object.defineProperty`
• 29. الگوی رایج: ذخیره مقدار در یک پراپرتی "خصوصی"
• 30. تکمیل دکوریتور `@log` با استفاده از Getter و Setter
• 31. مفهوم Decorator Factories: ساخت دکوریتورهای قابل تنظیم
• 32. ساخت اولین Decorator Factory: `@DefaultValue(value)`
• 33. مثال پیشرفته‌تر: ساخت دکوریتور `@configurable(false)`
• 34. ساخت دکوریتور `@readonly` برای جلوگیری از تغییر مقدار
• 35. مقدمه‌ای بر اعتبارسنجی (Validation) با دکوریتورها
• 36. ساخت دکوریتور `@Required`: ذخیره متادیتا برای فیلدهای ضروری
• 37. ساخت دکوریتور فکتوری `@MinLength(num)`
• 38. ساخت دکوریتور فکتوری `@MaxLength(num)`
• 39. ساخت دکوریتور `@Email` برای اعتبارسنجی فرمت ایمیل
• 40. ساخت دکوریتور `@Range(min, max)` برای اعتبارسنجی اعداد
• 41. ساخت یک تابع Validator: منطق اصلی اعتبارسنجی
• 42. خواندن متادیتای ذخیره شده روی پراپرتی‌های یک آبجکت
• 43. اجرای منطق اعتبارسنجی بر اساس متادیتا
• 44. نمایش خطاهای اعتبارسنجی به کاربر
• 45. زنجیره‌سازی (Chaining) دکوریتورها روی یک پراپرتی
• 46. ترتیب اجرای دکوریتورها: از پایین به بالا
• 47. استفاده از Symbol ها به عنوان کلید متادیتا برای جلوگیری از تداخل
• 48. ذخیره آبجکت‌های پیچیده به عنوان متادیتا
• 49. مقدمه‌ای بر مفهوم تزریق وابستگی (Dependency Injection)
• 50. چگونه Property Decorators تزریق وابستگی را ممکن می‌سازند؟
• 51. ساخت یک DI Container ساده: کلاس Container
• 52. دکوریتور کلاس `@Injectable`: نشانه‌گذاری کلاس‌های قابل تزریق
• 53. دکوریتور پراپرتی `@Inject`: درخواست یک وابستگی
• 54. منطق Container: ساخت و مدیریت نمونه‌های کلاس
• 55. حل وابستگی‌ها با استفاده از متادیتای `@Inject`
• 56. قدرت `emitDecoratorMetadata`: تزریق خودکار نوع
• 57. بررسی متادیتای `design:type`
• 58. بازنویسی DI Container برای استفاده از `design:type`
• 59. حل وابستگی‌های چرخه‌ای (Circular Dependencies): چالش‌ها
• 60. مثال کامل: استفاده از DI Container در یک برنامه کوچک
• 61. مقدمه‌ای بر ORM ها و نقش دکوریتورها (مانند TypeORM)
• 62. ساخت دکوریتور `@Entity` برای مدل‌ها
• 63. ساخت دکوریتور `@Column` برای تعریف ستون‌های جدول
• 64. افزودن گزینه‌ها به `@Column`: `({ type: 'string', length: 255 })`
• 65. ساخت دکوریتور `@PrimaryColumn` و `@Generated`
• 66. ساخت یک "Entity Manager" ساده برای تولید کوئری SQL
• 67. منطق خواندن متادیتای `@Column` برای ساخت `CREATE TABLE`
• 68. مقدمه‌ای بر سریال‌سازی (Serialization) و Deserialization
• 69. ساخت دکوریتور `@JsonProperty(name)` برای نگاشت نام فیلدها
• 70. نوشتن یک تابع `serialize` عمومی
• 71. منطق `serialize`: تبدیل یک نمونه کلاس به یک آبجکت JSON ساده
• 72. نوشتن یک تابع `deserialize` عمومی
• 73. منطق `deserialize`: تبدیل یک آبجکت ساده به نمونه‌ای از یک کلاس
• 74. مدیریت آبجکت‌های تودرتو در سریال‌سازی
• 75. مدیریت آرایه‌ها در سریال‌سازی
• 76. کاربرد در مدیریت پیکربندی (Configuration Management)
• 77. ساخت دکوریتور `@EnvVariable(name)` برای خواندن از متغیرهای محیطی
• 78. ساخت یک کلاس `ConfigService` برای بارگذاری پیکربندی
• 79. افزودن مقدار پیش‌فرض به `@EnvVariable`
• 80. تبدیل نوع خودکار در `@EnvVariable` (رشته 'true' به بولین `true`)
• 81. ترکیب انواع دکوریتورها: فراخوانی متادیتا پراپرتی از درون یک متد دکوریتور
• 82. مثال عملی: دکوریتور `@cache` برای متدها که از `@CacheKey` پراپرتی استفاده می‌کند
• 83. مدیریت `this` در توابع مبتنی بر متادیتا
• 84. اشتباهات رایج: درک نادرست از `target`
• 85. اشتباه رایج: فراموش کردن زمان اجرای دکوریتور
• 86. اشتباه رایج: تغییر مستقیم پروتوتایپ و عواقب آن
• 87. ملاحظات عملکرد (Performance) در استفاده سنگین از دکوریتورها
• 88. نحوه تست واحد (Unit Test) یک دکوریتور
• 89. Mock کردن `Reflect.getMetadata` و `Reflect.defineMetadata` در تست‌ها
• 90. نوشتن تست برای فریمورک اعتبارسنجی ساخته شده
• 91. نوشتن تست برای DI Container
• 92. تکنیک‌های دیباگ کردن دکوریتورها
• 93. بررسی دکوریتورها در فریمورک‌های واقعی: NestJS
• 94. بررسی دکوریتورها در فریمورک‌های واقعی: TypeORM
• 95. آینده دکوریتورها: پروپوزال Stage 3 جاوااسکریپت
• 96. تفاوت‌های کلیدی در سینتکس و قابلیت‌های Stage 3 Decorators
• 97. معرفی آبجکت Context در دکوریتورهای جدید
• 98. بهترین شیوه‌ها (Best Practices) در نوشتن دکوریتورهای خوانا و قابل نگهداری
• 99. چه زمانی از Property Decorators استفاده کنیم (و چه زمانی نکنیم)؟
• 100. جمع‌بندی دوره و گام‌های بعدی