✌️ ‏JsDoc چیه و چه تفاوتی با Ts داره؟

‏JSDoc یک سیستم Documentation برای جاوا اسکریپت هست که روی استانداردتر و درست‌تر نوشتن کدهای جاوا اسکریپت، براساس یکسری از پترن ها تمرکز داره. این سیستم براساس کامنت‌هایی که در خود سینتکس وجود داره کار میکنه.

🔵در پست های قبلی درباره اینکه TypeScript چیه صحبت کردیم، پس اینجا خیلی توضیح خاصی بابتش نمیدم تا به اصل مطلب برسیم.

برتری های ‏JSDoc نسبت به TypeScript

◀️انعطاف‌پذیری و سازگاری

‏JSDoc یک زبان یا تکنولوژی جدا از جاوا اسکریپت نیست. در واقع JSDoc همون جاوا اسکریپته با این تفاوت که شما برای تعریف بخش‌های مختلف از سیستم کامنت‌نویسی استفاده میکنید، و از تکنولوژی جداگونه‌ای مثل تایپ اسکریپت استفاده نخواهید کرد.

◀️حاشیه نویسی یا Code Annotation

‏JSDoc تنها یک ابزار Type Checking نیست بلکه میتونه، برای تولید مستندات و تشریح چگونگی کارکرد بخش‌های مختلف کدهاتون ازش استفاده کنید. تمام این موارد باعث میشه تا فرایند درک و نگهداری از کدها ساده‌تر بشه.

◀️حذف زمان کامپایل

یکی از اصلی‌ترین مزایای JSDoc حذف کردن فرایند کامپایلینگ هست. مرورگر نمیتونه به طور مستقیم تایپ اسکریپت رو بخونه و نیاز به کامپایل شدن به جاوا اسکریپت رو داره، و این ممکنه زمان بر باشه، ولی JsDoc مستقیما از خود جاوااسکریپت خونده میشه و در نتیجه سرعت بهتری خواهیم داشت.

برتری های TypeScript نسبت به JSDoc

◀️سیستم Static Type قدرتمندتر

 تایپ اسکریپت یک مدل قدرتمند و جامع، از تایپ‌های مختلف رو ارائه میکنه و همچنین امکانات کاملی برای Error Handling رو تحویل ما میده. برخلاف JSDoc که سیستم تایپینگ اون در داخل کد جاوا اسکریپت تعریف میشه، تایپ اسکریپت به صورت مستقل عمل می‌کنه و از یک سیستم منحصر به فرد استفاده می‌کنه.

◀️وجود Type Interface

با وجود سیستم تعریف تایپ داده‌ای، تایپ اسکریپت خودش هم میتونه تایپ داده‌ای یک متغیر رو براساس مقدار انتسابی تعیین کنه. این موضوع در بعضی از موارد باعث میشه تا نیازی به تعریف صریح تایپ های داده‌ای نباشه، و کدبیس ساده‌تری داشته باشیم.

◀️کامیونیتی و سازگارپذیری

تایپ اسکریپت خودش رو به سرعت با نسخه‌های جدید جاوا اسکریپت تطبیق میده و همچنین، کامیونیتی قدرتمندتری به نسبت JSDoc در اختیار داره. این موضوع باعث میشه که نسبت به JSDoc کمی دلسرد بشیم.


در نهایت باید بگیم که JSDoc به صورت رسمی به عنوان یک رقیب برای تایپ اسکریپت معرفی نشده، اما توانایی اینو داره که در آینده نه چندان دور با تایپ اسکریپت رقابت کنه. پیشنهاد میکنم یه سر به داکیومنتش بزنید‌.

Document 🌐

#jsdoc #typescript #different
@CodeModule