شرح تجميع TypeScript وكيفية تجميع التعليمات البرمجية وتشغيلها

TypeScript عبارة عن مجموعة فرعية من JavaScript ذات نوع ثابت يتم تجميعها إلى JavaScript عادي. لاستخدام TypeScript بشكل فعال، من الضروري فهم عملية التجميع. سيرشدك هذا الدليل خلال أساسيات تجميع وتشغيل كود TypeScript، من الإعداد إلى التنفيذ.

فهم تجميع TypeScript

لا يتم تنفيذ كود TypeScript مباشرةً بواسطة المتصفحات أو Node.js. بدلاً من ذلك، يجب تجميعه إلى JavaScript. يقوم مُجمِّع TypeScript، `tsc`، بتنفيذ هذه المهمة. تتضمن العملية تحويل ملفات TypeScript (`.ts`) إلى ملفات JavaScript (`.js`) يمكن تشغيلها في أي بيئة JavaScript.

إعداد بيئة TypeScript الخاصة بك

قبل أن تتمكن من تجميع كود TypeScript، تأكد من تثبيت Node.js وnpm. يمكنك تثبيت TypeScript عالميًا باستخدام npm:

npm install -g typescript

يقوم هذا الأمر بتثبيت مُجمِّع TypeScript (`tsc`) عالميًا، مما يجعله متاحًا من أي مكان على نظامك.

تجميع كود TypeScript

لتجميع ملف TypeScript، انتقل إلى دليل المشروع الخاص بك في المحطة الطرفية واستخدم الأمر `tsc` متبوعًا باسم الملف:

tsc filename.ts

استبدل `filename.ts` باسم ملف TypeScript الخاص بك. يقوم هذا الأمر بتجميع كود TypeScript في ملف JavaScript يحمل نفس الاسم ولكن بامتداد `.js`.

استخدام ملف تكوين TypeScript

يتم استخدام ملف `tsconfig.json` لتكوين خيارات مُجمِّع TypeScript وإعدادات المشروع. يمكنك إنشاء هذا الملف باستخدام:

npx tsc --init

فيما يلي مثال لملف `tsconfig.json` الأساسي:

{
  "compilerOptions": {
    "target": "es6",
    "module": "commonjs",
    "strict": true,
    "outDir": "./dist",
    "sourceMap": true
  },
  "include": [
    "src/**/*"
  ],
  "exclude": [
    "node_modules"
  ]
}

يحدد هذا التكوين أن TypeScript يجب أن يقوم بتجميع الكود إلى ECMAScript 6 (`es6`)، واستخدام وحدات CommonJS، وتمكين فحص النوع الصارم، وإخراج الملفات المترجمة إلى الدليل `dist`، وإنشاء خرائط المصدر للاستكشاف عن الأخطاء وإصلاحها.

تجميع كافة الملفات في مشروع

مع وجود ملف `tsconfig.json` في مكانه، يمكنك تجميع كافة ملفات TypeScript في مشروعك عن طريق تشغيل:

tsc

يقوم هذا الأمر بقراءة الملف `tsconfig.json` ويقوم بتجميع كافة ملفات TypeScript المحددة في التكوين.

تشغيل كود JavaScript المجمّع

بمجرد تجميع كود TypeScript إلى JavaScript، يمكنك تشغيله باستخدام Node.js أو تضمينه في مشروع ويب. لتشغيل ملف JavaScript باستخدام Node.js، استخدم:

node dist/filename.js

استبدل `filename.js` باسم ملف JavaScript المجمّع الموجود في الدليل `dist`.

أخطاء التجميع الشائعة

أثناء التجميع، قد تواجه أخطاء. فيما يلي بعض المشكلات الشائعة وكيفية حلها:

أخطاء بناء الجملة: تحقق من كود TypeScript الخاص بك بحثًا عن مشكلات بناء الجملة. سيوفر المترجم رسائل خطأ تشير إلى مكان وجود المشكلات.
أخطاء النوع: تأكد من أن الكود الخاص بك يتوافق مع نظام النوع الخاص بـ TypeScript. راجع تعليقات النوع وتأكد من تعريفها بشكل صحيح.
مشكلات التكوين: تأكد من أن ملف `tsconfig.json` الخاص بك تم تكوينه بشكل صحيح ومن وجوده في جذر دليل المشروع الخاص بك.

خاتمة

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

TypeScript تجميع مُجمِّع tsc إعداد تكوين tsconfig js كود تشغيل nodejs أخطاء تكوين مشروع