@توصیف کردننیکو
مهندس نرم افزار ساکن بلژیک ، من با JS کار می کنم ، دوست دارم با Rust کمانچه کنم.
JSDoc به اسناد JavaScript از طریق بلوک های نظر اشاره می کند ، مانند JavaDoc است. با استفاده از آن ، می توانید کد JavaScript خود را تایپ کنید و از تنظیم مرحله ساخت / تدوین در پروژه خود جلوگیری کنید. این روش هنوز به TypeScript نیاز دارد ، اما فقط برای توسعه ، ارسال کد شما نیست.
چرا کسی می خواهد از JSDoc به جای TypeScript برای بررسی نوع استفاده کند؟
اگر با استفاده از کتابخانه ای مانند React یک برنامه Frontend می سازید ، احتمالاً از ابزاری مانند Webpack (یا Vite) برای بسته بندی / کامپایل کد خود در JavaScript استفاده می کنید که مرورگرها می توانند آن را درک کنند. در این صورت ، شما همچنین می توانید از TypeScript استفاده کنید زیرا از قبل مرحله ساخت دارید. اگرچه اگر فکر می کنید Hot Reloading یا مرحله ساخت خیلی کند است ، JSDoc هنوز می تواند کمک کند.
اکنون اگر در حال ساخت کتابخانه هستید ، JSDoc واقعاً جذاب می شود. این به شما امکان می دهد کتابخانه خود را مستند کرده و بدون نیاز به مرحله ساخت ، کد خود را تایپ کنید. می توانید روی کدگذاری تمرکز کنید و سپس کتابخانه خود را همانطور که هست منتشر کنید.
بیایید مثالی بزنیم تا به شما در درک چگونگی بررسی نوع بررسی با JSDoc کمک کند.
/**
* Iterates over elements of array and invokes function for each element
* @template T the type of the array's...