خيارات المترجم في TypeScript

من موسوعة حسوب

يوضح الجدول التالي جميع الخيارات التي يمكن استعمالها مع مترجم TypeScript للتحكم بسير عمله والتعديل على سلوكه أثناء ترجمة الشيفرات.

الخيار النوع القيمة الافتراضية الوصف
‎--allowJs‎ ‎boolean‎ ‎false‎ السماح بترجمة ملفّات JavaScript.
‎--allowSyntheticDefaultImports‎ ‎boolean‎ ‎module === "system" ‎ أو أنّ الخيار ‎--esModuleInterop‎ مضبوط وقيمة ‎module‎ ليست ‎es2015‎ أو ‎esnext‎ السماح للاستيرادات الافتراضية من الوحدات التي لا تحتوي على تصديرات افتراضيّة. هذا لا يؤثر على الشيفرة المولَّدة، ويؤثر فقط على آلية التحقق من الأنواع.
‎--allowUnreachableCode‎ ‎boolean‎ ‎false‎ لا تُخبِر عن الأخطاء على الشيفرة التي لا يمكن الوصول إليها.
‎--allowUnusedLabels‎ ‎boolean‎ ‎false‎ لا تُخبِر عن الأخطاء على اللافتات (labels) غير المُستخدَمة.
‎--alwaysStrict‎ ‎boolean‎ ‎false‎ تفسير الشيفرة في الوضع الصارم وتوليد ‎"use strict"‎‎ لكل ملفّ مصدري.
‎--baseUrl‎ ‎string‎ ‎ المجلّد الأساس لتقرير أسماء الوحدات غير النسبيّة. انظر توثيق تقرير الوحدات للاستزادة.
‎--build‎

‎-b‎

‎boolean‎ ‎false‎ يَبني هذا المشروعَ وجميعَ اعتمادياته التي تُحدَّد عبر مراجع المشروع، لاحظ أن هذا الخيار ليس متوافقًا مع الخيارات الأخرى في هذه الصفحة. انظر توثيق مراجع المشروع للاستزادة.
‎--charset‎ ‎string‎ ‎"utf8"‎ مجموعة محارف (character set) الملفّات المُخرجَة.
‎--checkJs‎ ‎boolean‎ ‎false‎ الإخبار بالأخطاء في ملفّات ‎.js‎. استعمله مع الخيار ‎.--allowJs‎
‎--declaration‎

‎-d‎

‎boolean‎ ‎false‎ توليد ملفّ ‎.d.ts‎ المناسب.
‎--declarationDir‎ ‎string‎ مجلّد الإخراج (Output directory) لملفات التصريحات المُولَّدَة.
‎--declarationMap‎ ‎boolean‎ ‎false‎ يُنشئُ خريطة مصدريّة (sourcemap) لكل ملفّ ‎.d.ts‎‎ مناسب.
‎--diagnostics‎ ‎boolean‎ ‎false‎ اعرض معلوماتٍ تشخيصيّة.
‎--disableSizeLimit‎ ‎boolean‎ ‎false‎ عطِّل تقييد الحجم (size limitation) على مشروع JavaScript.
‎--downlevelIteration‎ ‎boolean‎ ‎false‎ وفِّر دعمًا كاملًا للكائنات القابلة للتكرار في كل من جمل ‎for..of‎، وعامل النشر والتفكيك عند استهداف النسخة ES5 أو ES3.
‎--emitBOM‎ ‎boolean‎ ‎false‎ ولِّد علامة ترتيب البايتات (BOM) بالترميز UTF-8 في بداية الملفّات المُخرجَة.
‎--emitDeclarationOnly‎ ‎boolean‎ ‎false‎ ولّد فقط ملفّات التصريحات ‎.d.ts‎.
‎--emitDecoratorMetadata‎ [1] ‎boolean‎ ‎false‎ ولِّد بيانات وصفيّة لنوع التصميم (design-type) للتصريحات المُزخرَفَة في الشيفرة المصدرية. انظر هذه الصفحة للمزيد من التفاصيل.
‎--esModuleInterop‎ ‎boolean‎ ‎false‎ ولِّد المُساعدين ‎__importStar‎ و‎__importDefault‎ لتوافقية نظام babel وفعّل ‎--allowSyntheticDefaultImports‎ لتوافقية نظام الأنواع.
‎--experimentalDecorators‎ [1] ‎boolean‎ ‎false‎ فعّل الدعم التجريبي لميّزة مزخرفات ES.
‎--extendedDiagnostics‎ ‎boolean‎ ‎false‎ أظهر معلوماتٍ تشخيصيّة مُفصَّلة.
‎--forceConsistentCasingInFileNames‎ ‎boolean‎ ‎false‎ منع مراجع إلى نفس الملفّ بحالات أحرف مختلفة (inconsistently-cased).
‎--help‎

‎‎-h‎‎

‎ اطبع رسالة المساعدة.
‎--importHelpers‎ ‎boolean‎ ‎false‎ استورد مساعدات الإخراج (__extends، و__rest، وغيرهما) من ‎.tslib‎
‎--inlineSourceMap‎ ‎boolean‎ ‎false‎ ولِّد نفس الملفّ مع خرائط مصدرية عوضًا عن توليد ملفّ منفصل.
‎--inlineSources‎ ‎boolean‎ ‎false‎ ولِّد الشيفرة المصدرية بجانب الخرائط المصدرية في ملف واحد؛ يتطلب ضبط الخيار ‎--inlineSourceMap‎‎ أو الخيار --sourceMap‎‎.
‎--init‎ ‎ يُهيّئُ مشروعَ TypeScript ويُنشئ ملفّ ‎tsconfig.json‎.
‎--isolatedModules‎ ‎boolean‎ ‎false‎ ترجمة كل ملفٍّ على أنه وحدة منفصلة (مثل ‎ts.transpileModule‎)
‎--jsx‎ ‎string‎ ‎"Preserve"‎ دعم ‎JSX‎ في ملفّات ‎.tsx‎: إما وضع ‎"React"‎ أو ‎"Preserve"‎. انظر توثيق JSX للاستزادة.‎
‎--jsxFactory‎ ‎string‎ ‎"React.createElement"‎ تحديد دالّة JSX المولِّدة لاستعمالها عند إخراج JSX بأسلوب React، يُمكن أن تكون الدالةُ مثلًا الدالةَ ‎React.createElement‎ أو الدالةَ ‎h‎.
‎--keyofStringsOnly‎ ‎boolean‎ ‎false‎ تقرير ‎keyof‎ إلى أسماء الخاصيات ذات السلاسل النصية فقط (وليس الأعداد أو الرموز).
‎--lib‎ ‎string[]‎ ‎قائمة ملفات المكتبات التي ستُضمَّن أثناء الترجمة.

القيم الممكنة هي كالآتي:

ES5

ES6

ES2015

ES7

ES2016

ES2017

ES2018

ESNext

DOM

DOM.Iterable

WebWorker

ScriptHost

ES2015.Core

ES2015.Collection

ES2015.Generator

ES2015.Iterable

ES2015.Promise

ES2015.Proxy

ES2015.Reflect

ES2015.Symbol

ES2015.Symbol.WellKnown

ES2016.Array.Include

ES2017.object

ES2017.Intl

ES2017.SharedMemory

ES2017.String

ES2017.TypedArrays

ES2018.Intl

ES2018.Promise

ES2018.RegExp

ESNext.AsyncIterable

ESNext.Array

ESNext.Intl

ESNext.Symbol

ملاحظة: إذا لم يُحدَّد الخيار ‎--lib‎ فستُحقَن قائمةُ مكتباتٍ افتراضيّة. المكتبات الافتراضية التي ستُحقَن هي:

  • عند الخيار ‎--target ES5‎:

‎DOM,ES5,ScriptHost‎

  • وعند الخيار ‎--target ES6‎:

‎DOM,ES6,DOM.Iterable,ScriptHost‎

‎--listEmittedFiles‎ ‎boolean‎ ‎false‎ طباعة أسماء الملفّات التي ستُولَّدها الترجمة.
‎--listFiles‎ ‎boolean‎ ‎false‎ طباعة أسماء الملفات التي ستُترجَم.
‎--locale‎ ‎string‎ ‎(حسب منصة المبرمج [نظام التشغيل مثلًا]) المحليّة التي ستُستَخدَم لعرض رسائل الخطأ.

القيم الممكنة هي:

  • الإنجليزية (الولايات المتحدة): en
  • التشيكية: cs
  • الألمانية: de
  • الإسبانية: es
  • الفرنسية: fr
  • الإيطالية: it
  • اليابانية: ja
  • الكورية: ko
  • البولندية: pl
  • البرتغالية (البرازيل): pt-BR
  • الروسية: ru
  • التركية: tr
  • الصينية المبسطة: zh-CN
  • الصينية التقليدية: zh-TW
‎--mapRoot‎ ‎string‎ ‎ يحدّد المكان الذي يجب فيه على مصحح الأخطاء أن يبحث عن مكان ملفات الخرائط (map files) بدلاً من الأماكن المولَّدَة. استخدم هذا الخيار إذا كانت ملفات ‎.map‎ موجودة في زمن التنفيذ في مكان مختلف عن ملفات ‎.js‎. سيُضمَّن المكان المحدَّد في الخريطة المصدريّة لتوجيه مصحح الأخطاء إلى مكان ملفات الخرائط.
‎--maxNodeModuleJsDepth‎ ‎number‎ ‎0‎ تحديد عمق الاعتماديات الأقصى للبحث تحت مجلّد ‎node_modules‎ وتحميل ملفات JavaScript. يُطبَّق فقط مع الخيار ‎--allowJs‎.
‎--module‎

‎-m‎

‎string‎ ‎target === "ES3" or "ES5" ? "CommonJS" : "ES6"‎ حدد توليد شيفرة الوحدة: "None" أو "CommonJS" أو "AMD" أو "System" أو "UMD" أو "ES6" أو "ES2015" أو "ESNext".
  • يمكن استخدام "AMD" و "System" فقط بالتزامن مع ‎--outFile.
  • قد تُستخدَم قيم "ES6" و "ES2015" عند استهداف النسخة "ES5" أو ما قبلها.
‎--moduleResolution‎ ‎string‎ ‎module === "AMD" or "System" or "ES6" ? "Classic" : "Node"‎ تحديد آلية تقرير الوحدات. إمّا آلية "Node" لنمط Node.js أو io.js. أو آلية "Classic". انظر توثيق تقرير الوحدات للاستزادة.
‎--newLine‎ ‎string‎ ‎(حسب المنصة) تحديد سلسلة نهاية السطر (end of line sequence) التي ستُستَخدَم عند إخراج الملفّات: ‎"crlf"‎ (منصة windows) أو "lf" (منصة unix).
‎--noEmit‎ ‎boolean‎ ‎false‎ لا تُخرِج أي مُخرجات.
‎--noEmitHelpers‎ ‎boolean‎ ‎false‎ لا تُولِّد دوال مساعدةً مخصّصة مثل ‎__extends‎ في المُخرَج المُترجَم.
‎--noEmitOnError‎ ‎boolean‎ ‎false‎ لا تُخرِج أي مخرجات إن أُبلِغَ عن أي أخطاء.
‎--noErrorTruncation‎ ‎boolean‎ ‎false‎ لا تقطِّع رسائل الخطأ.
‎--noFallthroughCasesInSwitch‎ ‎boolean‎ ‎false‎ أبلِغ عن الأخطاء في حالات السقوط (fallthrough) في جمل switch.
‎--noImplicitAny‎ ‎boolean‎ ‎false‎ أبلغ عن خطأ في التعبيرات والتصريحات التي تعتمد على نوعِ any ضمني.
‎--noImplicitReturns‎ ‎boolean‎ ‎false‎ أبلغ عن خطأ عندما لا تُعيد جميع مسارات الشيفرة (code paths) في الدالة أية قيمة.
‎--noImplicitThis‎ ‎boolean‎ ‎false‎ أبلغ عن خطأ في تعبيرات ‎this‎ ذات نوع ‎any‎ ضمني.
‎--noImplicitUseStrict‎ ‎boolean‎ ‎false‎ لا تولِّد تعليمات ‎"use strict"‎ في مُخرج الوحدة.
‎--noLib‎ ‎boolean‎ ‎false‎ لا تُضمِّن ملفّ المكتبة الافتراضية (‎lib.d.ts‎).
‎--noResolve‎ ‎boolean‎ ‎false‎ لا تُضِف مراجع الشرطات المائلة الثلاث (triple-slash references) أو أهداف استيراد الوحدات (module import targets) إلى قائمة الملفات المترجمة.
‎--noStrictGenericChecks‎ ‎boolean‎ ‎false‎ عطِّل التحقق الصارم (strict checking) من التواقيع المُعمَّمة (generic signatures) في أنواع الدوال.
‎--noUnusedLocals‎ ‎boolean‎ ‎false‎ الإبلاغ عن الأخطاء على الكائنات المحليّة غير المستخدمة.
‎--noUnusedParameters‎ ‎boolean‎ ‎false‎ الإبلاغ عن الأخطاء على المعاملات غير المستخدمة.
‎--out‎ ‎string‎ هذا الخيار مُهمَل، استخدم الخيار ‎--outFile‎ عوضًا عنه.‎
‎--outDir‎ ‎string‎ ‎ إعادة توجيه بنية الإخراج إلى المجلّد المُحدَّد.
‎--outFile‎ ‎string‎ ‎ تجميع وإخراج المُخرَجات إلى ملف واحد. يُحدَّد ترتيب التجميع عبر قائمة الملفّات المُمرَّرةِ إلى المترجم على سطر الأوامر وعبر مراجع الشرطات الثلاث والاستيرادات.
‎paths‎ [2] ‎Object‎ ‎ قائمة تخطيطات مسارات (path mapping entries) تربط بين أسماء الوحدات وأماكنها نسبةً إلى قيمة ‎baseUrl‎. انظر توثيق تقرير الوحدات للاستزادة.
‎--preserveConstEnums‎ ‎boolean‎ ‎false‎ لا تحذف تصريحات ‎_‎ في الشيفرة المُولَّدَة. انظر هذه الصفحة للاستزادة.
‎--preserveSymlinks‎ ‎boolean‎ ‎false‎ لا تُقرِّر روابط الوصلات الرمزية (symlink) إلى مساراتها الفعليّة؛ عالِج ملفّ symlink على أنّه ملفّ حقيقيّ.
‎--preserveWatchOutput‎ ‎boolean‎ ‎false‎ أبقِ على مخرجات الطرفية القديمة في وضع المراقبة (watch mode) عوضًا عن مسح الشاشة.
‎--pretty‎ ‎boolean‎ ‎true‎ إلّا في حالة استعمال أنبوب (piping) يشير إلى برنامج آخر أو في حالة إ عادة توجيه المخرجات إلى ملفٍّ. تنسيق الأخطاء والرسائل باستخدام الألوان والسياق.
‎--project‎

‎-p‎

‎string‎ ‎ ترجمة مشروعٍ مع تمرير ملفّ إعداداتٍ صالح. يمكن للمعامل أن يكون مسار ملفّ يشير إلى ملفّ إعدادات JSON صالح، أو إلى مجلّد يحتوي على ملفّ ‎tsconfig.json‎. انظر توثيف الملفّ ‎tsconfig.json‎ للاستزادة.
‎--reactNamespace‎ ‎string‎JSX ‎"React"‎ خيار مهمل. استعمل الخيار ‎--jsxFactory‎ عوضًا عنه.

يُحدِّد الكائن الذي سيُستدعى من أجل ‎createElement‎ و‎__spread‎ عند إخراج ملفّات ‎JSX‎ في وضع ‎"react"‎.

‎--removeComments‎ ‎boolean‎ ‎false‎ حذف جميع التعليقات إلا تعليقات ترويسات الحقوق التي تبتدئ بالمقطع ‎/*!‎.
‎--resolveJsonModule‎ ‎boolean‎ ‎false‎ تضمين الوحدات التي تُستورَد بامتداد ‎.json‎.
‎--rootDir‎ ‎string‎ ‎(يُستنتَج المجلّد الجذر المشترك من قائمة الملفات المُدخلَة) يُحدِّد المجلّد الجذر لملفات للملفّات المدخلَة. استعمله فقط للتحكم بهيكل المُجلّد المُخرَج مع ‎--outDir‎.
‎rootDirs‎[2] ‎string[]‎ ‎ قائمة المجلدات الجذر التي سيُمثِّل مُحتواها المُدمَج هيكل المشروع أثناء التنفيذ. انظر توثيق تقرير الوحدات للاستزادة.
‎--skipDefaultLibCheck‎ ‎boolean‎ ‎false‎ خيار مُهمَل. استعمل الخيار ‎--skipLibCheck‎ عوضًا عنه.

تخطَّ التحقق من أنواع ملفات تصريحات المكتبة الافتراضية. انظر هذه الصفحة للاستزادة.

‎--skipLibCheck‎ ‎boolean‎ ‎false‎ تجاهل التحقق من أنواع جميع ملفّات التصريحات (‎*.d.ts‎).
‎--sourceMap‎ ‎boolean‎ ‎false‎ يُولِّد ملفّ ‎.map‎ المناسب.
‎--sourceRoot‎ ‎string‎ ‎ يحدد المكان حيث يجب على مصحح الأخطاء العثور على ملفات TypeScript بدلاً من أماكن المصدر (source locations). استخدم هذا الخيار إذا كانت المصادر موجودة أثناء التنفيذ في مكان مختلف عن مكانها وقت التصميم (design-time). سيُضمَّن المكان المعطى في خريطة المصدر (sourceMap) لتوجيه مصحح الأخطاء إلى مكان الملفات المصدرية.
‎--strict‎ ‎boolean‎ ‎false‎ تفعيل جميع خيارات التحقق من الأنواع بصرامة.

تفعيل ‎--strict‎ سيُفعّل الخيارات التالية:

  • ‎--noImplicitAny‎
  • ‎--noImplicitThis‎
  • ‎--alwaysStrict‎
  • ‎--strictNullChecks‎
  • ‎--strictFunctionTypes‎
  • ‎--strictPropertyInitialization‎
‎--strictFunctionTypes‎ ‎boolean‎ ‎false‎ تعطيل التحقق من المعاملات ثنائية التغير (bivariant parameter) في أنواع الدوال.
‎--strictPropertyInitialization‎ ‎boolean‎ ‎false‎ تأكد من أنّ خاصيات الأصناف التي لا تحمل القيمة ‎undefined‎ مُهيّأة في الدالة البانية. هذا الخيار يتطلب تفعيل الخيار ‎--strictNullChecks‎ كذلك.
‎--strictNullChecks‎ ‎boolean‎ ‎false‎ في وضع التحقق الصارم من القيمة ‎null‎، لا تكون القيمتان ‎undefined‎ و‎null‎ في نطاق كل الأنواع الأخرى، ويمكن تعيينها فقط إلى نفسها وإلى ‎any‎ (باستثناء أنّ ‎undefined‎ قابل للتعيين للنوع ‎void‎ كذلك).
‎--stripInternal‎[1] ‎boolean‎ ‎false‎ لا تُولِّد تصريحاتٍ للشيفرة التي تحتوي على التعليق ‎/** @internal */‎ (الذي يمثّل حاشية خاصّة في نظام JSDoc).
‎--suppressExcessPropertyErrors‎ ‎boolean‎ ‎false‎ قمع تدقيقات الخاصية الزائدة (excess property checks) لقيم الكائنات الحرفية (object literals).
‎--suppressImplicitAnyIndexErrors‎ ‎boolean‎ ‎false‎ قمع أخطاء ‎_‎ لفهرسة الكائنات التي لا تملك تواقيع فهارس. انظر هذه الصفحة للاستزادة.
‎--target‎

‎-t‎

‎string‎ ‎"ES3"‎ تحديد نسخة ECMAScript الهدف:
  • ‎"ES3"‎ (النسخة الافتراضية)
  • ‎"ES5"‎
  • ‎"ES6"‎ أو ‎"ES2015"‎
  • ‎"ES2016"‎
  • ‎"ES2017"‎
  • ‎"ESNext"‎
‎--traceResolution‎ ‎boolean‎ ‎false‎ الإبلاغ عن رسائل التسجيل (log messages) الخاصة بتقرير الوحدات (module resolution).
‎--types‎ ‎string[]‎ ‎قائمة أسماء تعريفات الأنواع المرغوب تضمينها، انظر قسم ‎@types‎، و‎typeRoots‎، و‎types‎ للاستزادة.
‎--typeRoots‎ ‎string[]‎ ‎قائمة المجلّدات التي تحتوي على تعريفات الأنواع المرغوب تضمينها، انظر قسم ‎@types‎، و‎typeRoots‎، و‎types‎ للاستزادة.
‎--version‎

‎-v‎

‎ ‎ طباعة نسخة المترجم.
‎--watch‎

‎-w‎

‎ ‎‎ تشغيل المترجم في وضع المراقبة. مشاهدة الملفّات المدخلَة وإعادة ترجمتها عندما تتغيّر محتوياتها. يمكن ضبط إعدادات مشاهدة الملفات والمجلدات باستخدام متغير بيئةٍ (environment variable). انظر ضبط وضع المراقبة لمزيد من التفاصيل.
  • [1] هذه الخيارات تجريبيّة.
  • [2] هذه الخيارات مسموح بها فقط في ملفّ ‎tsconfig.json‎، وليس عبر سطر الأوامر.

انظر أيضًا

مصادر

مجلوبة من «https://wiki.hsoub.com/index.php?title=TypeScript/compiler_options&oldid=24255»