Package.json

```wiki

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

ملف `package.json` هو حجر الزاوية في أي مشروع Node.js. إنه بمثابة قلب المشروع، حيث يحتفظ ببيانات التعريف، والتبعيات، والبرامج النصية، وغيرها من المعلومات الهامة التي يحتاجها Node Package Manager (npm) أو Yarn لإدارة المشروع بشكل فعال. هذا المقال يهدف إلى توفير فهم شامل لملف `package.json` للمبتدئين، مع التركيز على هيكله، ومكوناته، وكيفية استخدامه.

ما هو ملف Package.json؟

ببساطة، `package.json` هو ملف نصي بتنسيق JSON (JavaScript Object Notation) يصف مشروع Node.js. يقع عادةً في الدليل الجذر للمشروع. يعمل هذا الملف ككتالوج للمشروع، ويوفر معلومات أساسية حوله. بدون `package.json`، يصبح إدارة التبعيات وتشغيل الأوامر الخاصة بالمشروع أكثر صعوبة.

يشبه `package.json` في بعض النواحي وصفة طهي. تحدد الوصفة المكونات (التبعيات) والخطوات (البرامج النصية) اللازمة لإنشاء طبق (المشروع).

هيكل ملف Package.json

ملف `package.json` يتكون من مجموعة من أزواج المفاتيح والقيم. كل مفتاح يمثل خاصية للمشروع، والقيمة المقابلة تحدد قيمة تلك الخاصية. إليك بعض الخصائص الأكثر شيوعاً:

خصائص ملف Package.json الشائعة

**الوصف** | **مثال** |

اسم المشروع. يجب أن يكون فريداً داخل سجل npm. | "my-node-project" |

رقم إصدار المشروع. يتبع نظام الإصدار الدلالي (Semantic Versioning). | "1.0.0" |

وصف موجز للمشروع. | "A simple Node.js application" |

نقطة الدخول الرئيسية للمشروع. عادةً ما تكون ملف JavaScript الذي يبدأ تشغيل التطبيق. | "index.js" |

مجموعة من الأوامر النصية التي يمكن تشغيلها باستخدام npm أو Yarn. | { "start": "node index.js", "test": "jest" } |

قائمة بالكلمات المفتاحية التي تصف المشروع. | ["node", "javascript", "api"] |

اسم وموقع المؤلف. | "John Doe <[email protected]>" |

ترخيص المشروع. | "MIT" |

قائمة بالتبعيات اللازمة لتشغيل المشروع في بيئة الإنتاج. | { "express": "^4.17.1" } |

قائمة بالتبعيات اللازمة لتطوير المشروع، مثل أدوات الاختبار. | { "jest": "^26.6.3" } |

عنوان مستودع الشفرة المصدرية للمشروع. | { "type": "git", "url": "https://github.com/example/my-node-project.git" } |

شرح مفصل للخصائص الرئيسية

• **name:** اسم المشروع يجب أن يكون فريداً على npmjs.com إذا كنت تخطط لنشر المشروع. يجب أن يتكون من حروف صغيرة، وأرقام، وشرطات، وشرطات سفلية.
• **version:** يستخدم نظام الإصدار الدلالي (SemVer) لتحديد إصدار المشروع. يتكون من ثلاثة أرقام: `major.minor.patch`.

   *   `major`: تغييرات غير متوافقة مع الإصدارات السابقة.
   *   `minor`: إضافة ميزات جديدة متوافقة مع الإصدارات السابقة.
   *   `patch`: إصلاحات للأخطاء متوافقة مع الإصدارات السابقة.

• **dependencies:** هذه هي التبعيات الأساسية التي يحتاجها تطبيقك ليعمل. يتم تثبيتها باستخدام الأمر `npm install` أو `yarn install`. يمكن تحديد نطاقات الإصدار باستخدام رموز مثل `^` (متوافق مع الإصدارات السابقة) و `~` (متوافق مع الإصدارات الفرعية).
• **devDependencies:** هذه التبعيات مخصصة فقط للتطوير والاختبار. لن يتم تضمينها في حزمة الإنتاج. أمثلة على `devDependencies` تشمل أدوات الاختبار (مثل Jest)، وأدوات التنسيق (مثل ESLint)، وأدوات البناء (مثل Webpack).
• **scripts:** تسمح لك هذه الخاصية بتحديد أوامر نصية مخصصة يمكن تشغيلها باستخدام npm أو Yarn. على سبيل المثال، يمكنك تحديد أمر نصي لبدء التطبيق، وتشغيل الاختبارات، وبناء المشروع.

إنشاء ملف Package.json

هناك طريقتان رئيسيتان لإنشاء ملف `package.json`:

1. **باستخدام الأمر `npm init`:** افتح موجه الأوامر أو الطرفية، وانتقل إلى دليل المشروع، ثم قم بتشغيل الأمر `npm init`. سيطرح عليك npm سلسلة من الأسئلة حول المشروع، مثل الاسم، والإصدار، والوصف. بعد الإجابة على هذه الأسئلة، سيقوم npm بإنشاء ملف `package.json` بناءً على إجاباتك. 2. **يدوياً:** يمكنك إنشاء ملف `package.json` بنفسك باستخدام محرر نصوص. تأكد من أن الملف بتنسيق JSON صالح. يمكنك البدء بملف فارغ وإضافة الخصائص المطلوبة.

إدارة التبعيات

تعد إدارة التبعيات جزءاً أساسياً من تطوير Node.js. يساعدك npm أو Yarn على تثبيت، وتحديث، وإزالة التبعيات بسهولة.

• **تثبيت التبعيات:** استخدم الأمر `npm install <package-name>` أو `yarn add <package-name>` لتثبيت حزمة جديدة.
• **تحديث التبعيات:** استخدم الأمر `npm update` أو `yarn upgrade` لتحديث جميع التبعيات إلى أحدث الإصدارات المتوافقة.
• **إزالة التبعيات:** استخدم الأمر `npm uninstall <package-name>` أو `yarn remove <package-name>` لإزالة حزمة.

استخدام البرامج النصية (Scripts)

تتيح لك الخاصية `scripts` في `package.json` تحديد أوامر نصية مخصصة يمكن تشغيلها باستخدام npm أو Yarn. على سبيل المثال:

• `npm start`: يبدأ تشغيل التطبيق.
• `npm test`: يشغل الاختبارات.
• `npm build`: يبني المشروع.

لتشغيل برنامج نصي، استخدم الأمر `npm run <script-name>` أو `yarn <script-name>`.

أمثلة على ملف Package.json

```json {

 "name": "my-simple-app",
 "version": "1.0.0",
 "description": "A simple Node.js application",
 "main": "index.js",
 "scripts": {
   "start": "node index.js",
   "test": "jest"
 },
 "keywords": [
   "node",
   "javascript",
   "api"
 ],
 "author": "John Doe <[email protected]>",
 "license": "MIT",
 "dependencies": {
   "express": "^4.17.1"
 },
 "devDependencies": {
   "jest": "^26.6.3"
 }

} ```

أهمية ملف Package.json في الخيارات الثنائية (Binary Options)

على الرغم من أن `package.json` لا يرتبط بشكل مباشر بتداول الخيارات الثنائية، إلا أنه يمكن أن يكون ضرورياً في تطوير أدوات أو تطبيقات برمجية تستخدم في تحليل بيانات السوق، أو تنفيذ استراتيجيات التداول الآلية. على سبيل المثال:

• **تطوير مؤشرات فنية:** يمكن استخدام Node.js و `package.json` لتطوير مكتبات JavaScript تحتوي على مؤشرات فنية مثل المتوسطات المتحركة ([Moving Averages](https://www.investopedia.com/terms/m/movingaverage.asp))، ومؤشر القوة النسبية ([Relative Strength Index (RSI)](https://www.investopedia.com/terms/r/rsi.asp))، وخطوط بولينجر ([Bollinger Bands](https://www.investopedia.com/terms/b/bollingerbands.asp)).
• **تحليل حجم التداول:** يمكن استخدام Node.js لتحليل بيانات حجم التداول ([Volume Analysis](https://www.investopedia.com/terms/v/volume.asp)) وتحديد الاتجاهات المحتملة.
• **تنفيذ استراتيجيات تداول آلية:** يمكن استخدام Node.js لتطوير روبوتات تداول ([Trading Bots](https://www.investopedia.com/terms/a/algorithmic-trading.asp)) تقوم بتنفيذ الصفقات بناءً على قواعد محددة مسبقاً. مثال على استراتيجية: [استراتيجية مارتينجال](https://www.babypips.com/forex/trading/martingale-strategy).
• **واجهات برمجة التطبيقات (APIs):** يمكن إنشاء واجهات برمجة تطبيقات ([APIs](https://www.investopedia.com/terms/a/api.asp)) باستخدام Node.js و Express.js (المدرجة كـ `dependency` في `package.json`) للحصول على بيانات الأسعار في الوقت الفعلي من منصات تداول الخيارات الثنائية.
• **تحليل بيانات تاريخية:** يمكن استخدام Node.js لتحليل البيانات التاريخية ([Historical Data Analysis](https://www.investopedia.com/terms/h/historicaldata.asp)) لتحديد الأنماط والاتجاهات.
• **استراتيجيات تداول قائمة على التعلم الآلي:** يمكن استخدام مكتبات التعلم الآلي ([Machine Learning Libraries](https://www.investopedia.com/terms/m/machinelearning.asp)) في Node.js و `package.json` لتدريب نماذج تنبؤية لأسعار الخيارات الثنائية. مثال: [شبكات عصبية](https://www.investopedia.com/terms/n/neuralnetwork.asp).
• **استراتيجية المضاربة على الاختراق (Breakout Trading Strategy):** يمكن تطوير أدوات لتحديد مستويات الاختراق المحتملة.
• **استراتيجية تداول النطاق (Range Trading Strategy):** يمكن تطوير أدوات لتحديد نطاقات التداول.
• **استراتيجية تداول الزخم (Momentum Trading Strategy):** يمكن تطوير أدوات لقياس زخم السوق.
• **استراتيجية التداول العكسي (Reversal Trading Strategy):** يمكن تطوير أدوات لتحديد انعكاسات الاتجاه.
• **استراتيجية تداول الأنماط (Pattern Trading Strategy):** يمكن تطوير أدوات للتعرف على الأنماط الرسومية.
• **استراتيجية تداول الفجوات (Gap Trading Strategy):** يمكن تطوير أدوات لتحديد الفجوات السعرية.
• **استراتيجية تداول على أساس الأخبار (News Trading Strategy):** يمكن تطوير أدوات لتحليل الأخبار وتأثيرها على الأسعار.
• **استراتيجية تداول الاتجاه (Trend Following Strategy):** يمكن تطوير أدوات لتحديد واتباع الاتجاهات.
• **استراتيجية تداول المتوسطات المتحركة المتقاطعة (Moving Average Crossover Strategy):** يمكن تطوير أدوات لتحديد تقاطعات المتوسطات المتحركة.
• **استراتيجية تداول تصحيح فيبوناتشي (Fibonacci Retracement Strategy):** يمكن تطوير أدوات لتحديد مستويات تصحيح فيبوناتشي.
• **استراتيجية تداول RSI Divergence:** يمكن تطوير أدوات لتحديد تباين RSI.
• **استراتيجية تداول MACD Crossover:** يمكن تطوير أدوات لتحديد تقاطعات MACD.
• **استراتيجية تداول Stochastic Oscillator:** يمكن تطوير أدوات لاستخدام مؤشر ستوكاستيك.
• **استراتيجية تداول Ichimoku Cloud:** يمكن تطوير أدوات لاستخدام سحابة Ichimoku.
• **استراتيجية تداول Elliott Wave:** يمكن تطوير أدوات لتحليل موجات إليوت.

في كل هذه الحالات، يكون ملف `package.json` ضرورياً لتحديد التبعيات اللازمة لتشغيل هذه الأدوات والتطبيقات.

الخلاصة

ملف `package.json` هو جزء أساسي من أي مشروع Node.js. فهو يوفر معلومات مهمة حول المشروع، ويساعد على إدارة التبعيات، ويسمح بتحديد أوامر نصية مخصصة. فهم `package.json` أمر بالغ الأهمية لأي مطور Node.js، سواء كان يعمل على تطبيقات ويب، أو أدوات سطر الأوامر، أو حتى أدوات تحليل بيانات السوق المستخدمة في تداول الخيارات الثنائية.

Node.js npm yarn JSON Semantic Versioning Dependencies Scripts Module System Node Package Manager Express.js Git GitHub JavaScript API الخيارات الثنائية تحليل فني إدارة المخاطر استراتيجيات التداول

]] ```

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

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

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

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