Tsconfig.json

```wiki

Tsconfig.json: دليل شامل للمبتدئين

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

ما هو TypeScript ولماذا نستخدم Tsconfig.json؟

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

عند كتابة كود TypeScript، لا يمكن للمتصفحات أو بيئات التشغيل (مثل Node.js) تنفيذه مباشرة. يجب أولاً ترجمة كود TypeScript إلى JavaScript باستخدام مترجم TypeScript. هنا يأتي دور tsconfig.json. فهو يخبر المترجم كيف يقوم بهذه الترجمة، مثل:

إصدار JavaScript المستهدف (ES5, ES6, ESNext, إلخ).
مستوى التحقق من الأخطاء (strictness).
مكان البحث عن ملفات التعريف (declaration files) و ملفات JavaScript الأخرى.
كيفية تنظيم الكود الناتج.

بدون tsconfig.json، سيتعين عليك تحديد هذه الخيارات يدويًا في سطر الأوامر في كل مرة تقوم فيها بترجمة الكود، وهو أمر غير عملي.

إنشاء ملف Tsconfig.json

يمكنك إنشاء ملف tsconfig.json يدويًا أو باستخدام الأمر `tsc --init` في سطر الأوامر. هذا الأمر سيقوم بإنشاء ملف tsconfig.json افتراضي يحتوي على مجموعة من الخيارات الشائعة. يمكنك بعد ذلك تعديل هذا الملف ليناسب احتياجات مشروعك.

الخيارات الأساسية في Tsconfig.json

ملف tsconfig.json هو كائن JSON يحتوي على مجموعة من الخيارات. فيما يلي بعض الخيارات الأساسية الأكثر استخدامًا:

الخيارات الأساسية في Tsconfig.json
الخيار (Option)	الوصف (Description)	القيمة الافتراضية (Default Value)
compilerOptions.target	يحدد إصدار JavaScript المستهدف.	ES5
compilerOptions.module	يحدد نظام الوحدات النمطية (module system) المستخدم.	CommonJS
compilerOptions.outDir	يحدد المجلد الذي سيتم فيه وضع ملفات JavaScript المترجمة.	"./dist"
compilerOptions.rootDir	يحدد المجلد الجذر لمصادر TypeScript.	"."
compilerOptions.sourceMap	يحدد ما إذا كان سيتم إنشاء ملفات source map.	false
compilerOptions.strict	يحدد ما إذا كان سيتم تفعيل وضع التحقق الصارم.	false
compilerOptions.esModuleInterop	يتيح التوافق مع وحدات CommonJS النمطية.	false
compilerOptions.skipLibCheck	يتخطى التحقق من ملفات التعريف (declaration files).	false
compilerOptions.forceConsistentCasingInFileNames	يفرض استخدام حالة الأحرف المتسقة في أسماء الملفات.	false
include	يحدد قائمة الملفات أو الأنماط التي يجب تضمينها في عملية الترجمة.	["*/"]
exclude	يحدد قائمة الملفات أو الأنماط التي يجب استبعادها من عملية الترجمة.	["node_modules"]

compilerOptions.target: يحدد إصدار ECMAScript (JavaScript) الذي يجب أن يستهدفه المترجم. على سبيل المثال، `ES5` يدعم المتصفحات القديمة، بينما `ESNext` يستخدم أحدث الميزات. عند اختيار `ES6` أو أحدث، تأكد من أن بيئة التشغيل الخاصة بك تدعم هذه الميزات.
compilerOptions.module: يحدد نظام الوحدات النمطية الذي سيتم استخدامه. تشمل الخيارات الشائعة `CommonJS` (لـ Node.js)، `ESNext` (للمتصفحات الحديثة)، و `AMD` (لـ RequireJS).
compilerOptions.outDir: يحدد المجلد الذي سيتم وضع ملفات JavaScript المترجمة فيه. عادةً ما يتم استخدام مجلد `dist` أو `build`.
compilerOptions.rootDir: يحدد المجلد الجذر لمصادر TypeScript. يستخدم هذا الخيار لتحديد مسار الملفات بشكل صحيح في ملفات JavaScript المترجمة.
compilerOptions.sourceMap: يحدد ما إذا كان سيتم إنشاء ملفات source map أم لا. تسمح ملفات source map بتصحيح أخطاء كود JavaScript المترجم في المتصفح كما لو كانت كود TypeScript الأصلي.
compilerOptions.strict: تفعيل هذا الخيار يقوم بتفعيل مجموعة من الخيارات الأكثر صرامة، مما يساعد في اكتشاف المزيد من الأخطاء المحتملة.
compilerOptions.esModuleInterop: يساعد في التوافق بين وحدات CommonJS و ES Modules.
compilerOptions.skipLibCheck: يمكن أن يسرع عملية الترجمة عن طريق تخطي التحقق من ملفات التعريف (declaration files).
compilerOptions.forceConsistentCasingInFileNames: يضمن أن أسماء الملفات حساسة لحالة الأحرف.
include: يحدد قائمة الملفات أو الأنماط التي يجب تضمينها في عملية الترجمة. يستخدم عادةً لتضمين جميع ملفات TypeScript في مشروعك.
exclude: يحدد قائمة الملفات أو الأنماط التي يجب استبعادها من عملية الترجمة. عادةً ما يتم استبعاد مجلد `node_modules` وملفات التهيئة الأخرى.

خيارات متقدمة

بالإضافة إلى الخيارات الأساسية، هناك العديد من الخيارات المتقدمة التي يمكن استخدامها لتخصيص عملية الترجمة بشكل أكبر. بعض هذه الخيارات تشمل:

compilerOptions.declaration: يحدد ما إذا كان سيتم إنشاء ملفات تعريف (declaration files) أم لا. ملفات التعريف تحتوي على معلومات حول أنواع المتغيرات والدوال والوحدات النمطية في كود TypeScript.
compilerOptions.noImplicitAny: يمنع استخدام النوع `any` بشكل ضمني. هذا الخيار يساعد في تحسين أمان النوع.
compilerOptions.removeComments: يزيل التعليقات من كود JavaScript المترجم.
compilerOptions.experimentalDecorators: يمكّن دعم decorators، وهي ميزة تجريبية في TypeScript.
compilerOptions.emitDecoratorMetadata: ينتج بيانات تعريف decorator، والتي يمكن استخدامها بواسطة أطر عمل مثل Angular.
compilerOptions.lib: يحدد مكتبات التعريف (declaration libraries) المراد تضمينها في عملية الترجمة.

استخدام ملفات تعريف (Declaration Files)

ملفات التعريف (عادةً ما تكون بامتداد `.d.ts`) توفر معلومات حول أنواع المتغيرات والدوال والوحدات النمطية في كود TypeScript. تستخدم هذه الملفات لتوفير دعم للأنواع لمكتبات JavaScript الخارجية. يمكنك استخدام الخيار `compilerOptions.lib` في tsconfig.json لتحديد المكتبات التي يجب تضمينها في عملية الترجمة.

التعامل مع الأخطاء

عندما يواجه مترجم TypeScript خطأً، فإنه سيعرض رسالة خطأ تحتوي على معلومات حول الخطأ وموقعه في الكود. يمكنك استخدام الخيارات `compilerOptions.strict` و `compilerOptions.noImplicitAny` لتفعيل المزيد من عمليات التحقق من الأخطاء.

أمثلة عملية

مثال 1: مشروع بسيط يستهدف ES5

```json {

 "compilerOptions": {
   "target": "ES5",
   "module": "CommonJS",
   "outDir": "./dist",
   "strict": true
 },
 "include": ["src/**/*"]

} ```

مثال 2: مشروع يستخدم ES6 ويولد ملفات تعريف

```json {

 "compilerOptions": {
   "target": "ES6",
   "module": "ESNext",
   "outDir": "./dist",
   "declaration": true,
   "strict": true
 },
 "include": ["src/**/*"],
 "exclude": ["node_modules"]

} ```

ربط بمواضيع ذات صلة

TypeScript: اللغة الأساسية.
مترجم TypeScript: أداة الترجمة.
ملفات التعريف (Declaration Files): شرح مفصل لوظيفة ملفات التعريف.
نظام الوحدات النمطية (Module System): شرح لأنواع الوحدات النمطية المختلفة.
ES Modules: شرح لنظام ES Modules.
CommonJS: شرح لنظام CommonJS.
أمان النوع (Type Safety): أهمية أمان النوع في TypeScript.
Decorators: شرح لميزة decorators التجريبية.
Angular: إطار عمل يستخدم TypeScript على نطاق واسع.
Node.js: بيئة تشغيل JavaScript تستخدم TypeScript بشكل متزايد.

استراتيجيات الخيارات الثنائية والتحليل الفني (للمطورين المهتمين بالاستثمار)

على الرغم من أن هذا المقال يركز على TypeScript، فمن المهم للمطورين فهم أساسيات الاستثمار والتحليل الفني. فيما يلي بعض الاستراتيجيات والمفاهيم ذات الصلة بالخيارات الثنائية:

**استراتيجية مارتينجال:** استراتيجية مضاربة عالية المخاطر تعتمد على مضاعفة الرهان بعد كل خسارة.
**استراتيجية فيبوناتشي:** تستخدم نسب فيبوناتشي لتحديد نقاط الدخول والخروج المحتملة.
**تحليل الاتجاه:** تحديد اتجاه السوق (صاعد، هابط، جانبي).
**مؤشر القوة النسبية (RSI):** مؤشر يقيس سرعة وتغير تحركات الأسعار.
**المتوسطات المتحركة (Moving Averages):** تستخدم لتنعيم بيانات الأسعار وتحديد الاتجاهات.
**تحليل حجم التداول (Volume Analysis):** دراسة حجم التداول لتأكيد الاتجاهات وتحديد نقاط التحول.
**استراتيجية الاختراق:** الرهان على اختراق مستوى سعر رئيسي.
**استراتيجية الارتداد:** الرهان على ارتداد السعر عن مستوى دعم أو مقاومة.
**استراتيجية النطاق:** الرهان على بقاء السعر ضمن نطاق سعري محدد.
**تحليل الشموع اليابانية (Candlestick Patterns):** التعرف على أنماط الشموع اليابانية للتنبؤ بتحركات الأسعار.
**استراتيجية 60 ثانية:** استراتيجية تداول قصيرة الأجل تعتمد على توقع حركة السعر خلال 60 ثانية.
**استراتيجية 5 دقائق:** استراتيجية تداول متوسطة الأجل تعتمد على توقع حركة السعر خلال 5 دقائق.
**استراتيجية 15 دقيقة:** استراتيجية تداول طويلة الأجل تعتمد على توقع حركة السعر خلال 15 دقيقة.
**استراتيجية المؤشرات المتعددة:** الجمع بين عدة مؤشرات فنية لاتخاذ قرارات تداول أكثر دقة.
**تحليل المخاطر وإدارة رأس المال:** تحديد مستوى المخاطر المقبول وتخصيص رأس المال بشكل فعال.
**استراتيجية الدعم والمقاومة:** تحديد مستويات الدعم والمقاومة الرئيسية للتنبؤ بتحركات الأسعار.
**استراتيجية خطوط الاتجاه:** رسم خطوط الاتجاه لتحديد الاتجاهات وتحديد نقاط الدخول والخروج المحتملة.
**استراتيجية القنوات:** استخدام القنوات لتحديد نطاقات الأسعار المحتملة.
**استراتيجية المثلثات:** التعرف على أنماط المثلثات للتنبؤ بتحركات الأسعار.
**استراتيجية الأعلام والشارات:** التعرف على أنماط الأعلام والشارات للتنبؤ بتحركات الأسعار.
**استراتيجية التداول العكسي:** الرهان على عكس الاتجاه الحالي.
**استراتيجية التداول مع الاتجاه:** الرهان على استمرار الاتجاه الحالي.
**استراتيجية التداول الموسمية:** الرهان على الأنماط الموسمية في الأسعار.
**استراتيجية التداول الإخباري:** الرهان على تأثير الأخبار على الأسعار.
**تحليل حجم الفائدة المفتوحة (Open Interest):** دراسة حجم الفائدة المفتوحة لتقييم قوة الاتجاه.

هام: تداول الخيارات الثنائية ينطوي على مخاطر عالية. يجب عليك فهم المخاطر بشكل كامل قبل البدء في التداول. هذا المقال ليس نصيحة استثمارية.

الخلاصة

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

ابدأ التداول الآن

سجّل في IQ Option (الحد الأدنى للإيداع 10 دولار) افتح حساباً في Pocket Option (الحد الأدنى للإيداع 5 دولار)

انضم إلى مجتمعنا

اشترك في قناة Telegram الخاصة بنا @strategybin لتصلك: ✓ إشارات تداول يومية ✓ تحليلات استراتيجية حصرية ✓ تنبيهات اتجاهات السوق ✓ مواد تعليمية للمبتدئين