استخدام ملفات التصريحات في TypeScript
أصبح استخدام ملفات التصريحات سهلًا جدًّا منذ النسخة 2.0 من TypeScript، إذ أصبح الحصول عليها واستخدامها والعثور عليها أبسط من ذي قبل. ستساعدك هذه الصفحة على القيام بهذه العمليات الثلاث.
تنزيل ملفات التصريحات
لا يحتاج الحصول على ملفات التصريحات إلى أي أدوات غير أداة npm في TypeScript 2.0 وما تلاها من نسخ.
على سبيل المثال، يمكن الحصول على التصريحات لمكتبةٍ مثل lodash ببساطة بالأمر التالي فقط:
npm install --save @types/lodash
من الجدير بالذكر أنّ تنزيل حزمةِ @types لمكتبةٍ غير ضروري إذا كانت حزمة npm تُحزِّم ملفّ تصريحاتها، كما وصفنا في صفحة نشر ملفات التصريحات.
الاعتماد على ملف التصريحات
بعد الخطوة السابقة، يمكنك استخدام lodash في شيفرة TypeScript مباشرةً. ويمكنك الاعتماد عليها في الوحدات والشيفرة العامة (global code) كذلك.
مثلًا، بعد تثبيت تصريحاتك باستخدام npm install، يمكنك استعمال المكتبة كالتالي:
import * as _ from "lodash";
_.padStart("Hello TypeScript!", 20, " ");
وإن كنت لا تستخدم الوحدات، فيمكنك فقط استعمال المتغير العام الذي توفره المكتبة (_ في مكتبة lodash):
_.padStart("Hello TypeScript!", 20, " ");
البحث والعثور عن ملفات التصريحات
تحمل حزم تصريحات الأنواع في أغلب الأحوال نفسَ اسم الحزمة على npm، لكن مع السابقة @types/، لكن إن احتجت إلى البحث عنها، فاستعمل محرك البحث هذا للبحث عن الحزمة لمكتبتك.
ملاحظة: إذا كان ملف التصريحات الذي تبحث عنه غير موجود، فيمكنك دائمًا المساهمة ومساعدة المطور التالي الذي سيبحث عنه بعدَك. يمكنك الحصول على المزيد من التفاصيل في صفحة إرشادات المساهمة.