ترجمة ملف TypeScript

  • 5 دقائق

كما تعلمت سابقا، TypeScript هي مجموعة فائقة صارمة من ECMAScript 2015 (ECMAScript 6 أو ES6). جميع التعليمات البرمجية ل JavaScript هي أيضا تعليمة TypeScript البرمجية، ويمكن لبرنامج TypeScript أن يستهلك JavaScript بسلاسة. في الواقع، يمكنك تحويل ملف JavaScript إلى ملف TypeScript فقط عن طريق إعادة تسمية الملحق من .js إلى .ts.

ومع ذلك، ليس كل تعليمة TypeScript البرمجية هو تعليمة JavaScript برمجية. يضيف TypeScript بناء جملة جديدا إلى JavaScript، ما يسهل قراءة JavaScript وينفذ بعض الميزات، مثل الكتابة الثابتة. على الرغم من أن التعليمة البرمجية TypeScript تجعل التطوير أسهل وأقل عرضة للخطأ، فإن المستعرضات ومعظم أوقات التشغيل الأخرى لا تدعم أصلاً TypeScript. لهذا السبب، يتطلب TypeScript خطوة بناء (transpiler) لتحويله إلى JavaScript لكي يعمل التطبيق الخاص بك.

يمكنك تحويل التعليمات البرمجية TypeScript إلى تعليمة برمجية JavaScript باستخدام المحول البرمجي TypeScript، أو يمكنك استخدام محول برمجي متوافق مع TypeScript، مثل Babel أو swc أو Sucrase. تقوم هذه العملية بإزالة التعليمات البرمجية الخاصة TypeScript (على سبيل المثال، نوع تعريفات وواجهات). بالإضافة إلى ذلك، فإنه ينشئ ملف JavaScript نظيفًا يمكنك تشغيله من صفحات الويب الخاصة بك، وهو متوافق مع المتصفحات.

ترجمة ملف TypeScript

يمكنك تشغيل المحول البرمجي TypeScript في موجه الأوامر باستخدام tsc الأمر . عند التشغيل tsc بدون معلمات، فإنه يقوم بتجميع جميع ملفات .ts في المجلد الحالي وإنشاء ملف .js لكل ملف.

يمكنك أيضًا ترجمة ملف معين. على سبيل المثال، لإجراء تحويل برمجي لملف TypeScript يسمى utility_functions.ts، أدخل tsc utility_functions.ts.

إشعار

إدخال ملحق ملف .ts اختياري.

إذا لم تكن هناك أخطاء للمحول البرمجي، يقوم الأمر tsc بإنشاء ملف JavaScript باسم utility_functions.js.

إذا عثر المحول البرمجي على أخطاء في التعليمات البرمجية، فإنه يعرضها في إطار الأوامر. قم بإصلاح الأخطاء في ملف TypeScript، ثم أعد تشغيل tsc الأمر.

خيارات المحول البرمجي

باستخدام خيارات برنامج التحويل البرمجي، يمكنك التحكم في كيفية إنشاء JavaScript من المصدر TypeScript. يمكنك تعيين الخيارات إما في موجه الأوامر، كما تفعل مع العديد من واجهات سطر الأوامر، أو في ملف JSON يسمى tsconfig.json.

تتوفر العديد من خيارات المحول البرمجي لك. يمكنك العثور على قائمة كاملة من الخيارات في وثائق واجهات سطر الأوامر tsc. فيما يلي بعض الخيارات الأكثر شيوعًا:

  • noImplicitAny
  • noEmitOnError
  • target
  • خيارات الدليل

للتحكم في التحويل البرمجي، يمكنك استخدام خيارات المحول البرمجي مع الأمر، بما في tsc ذلك:

  • يرشد --noImplicitAny الخيار المحول البرمجي إلى رفع أخطاء في التعبيرات والإعلانات بنوع ضمني any . على سبيل المثال:

    tsc utility_functions.ts --noImplicitAny

  • --target يحدد الخيار الإصدار الهدف ECMAScript لملف JavaScript. يقوم هذا المثال بتجميع ملف JavaScript متوافق مع ECMAScript 6:

    tsc utility_functions.ts --target "ES2015"

ستتعلم خيارات المحول البرمجي الأخرى في الوحدات النمطية اللاحقة.