Npm Documentation

```wiki

توثيق Npm: دليل شامل للمبتدئين

Npm (اختصار لـ Node Package Manager) هو مدير حزم لـ Node.js، وهو بيئة تشغيل جافاسكربت من جانب الخادم. على الرغم من اسمه، يمكن استخدام Npm لإدارة الحزم في مشاريع جافاسكربت من جانب العميل أيضاً. يعتبر Npm أداة أساسية لأي مطور جافاسكربت، حيث يسهل عملية تثبيت وإدارة المكتبات والأدوات التي يحتاجها مشروعك. يهدف هذا المقال إلى تقديم شرح مفصل لـ Npm للمبتدئين، بدءًا من المفاهيم الأساسية وصولاً إلى الاستخدامات المتقدمة.

ما هي الحزمة (Package)؟

قبل الغوص في تفاصيل Npm، من المهم فهم مفهوم "الحزمة". الحزمة هي مجموعة من الملفات (مثل كود جافاسكربت، الصور، ملفات CSS، وما إلى ذلك) التي توفر وظيفة معينة. يمكن أن تكون الحزمة مكتبة، أداة، أو حتى تطبيق كامل. تأتي الحزم مع ملف يسمى package.json، والذي يحتوي على معلومات حول الحزمة، مثل اسمها، إصدارها، المؤلف، التبعيات، والنصوص البرمجية. يسمح package.json لـ Npm بفهم كيفية تثبيت الحزمة واستخدامها.

تثبيت Npm

عادةً ما يتم تثبيت Npm تلقائيًا عند تثبيت Node.js. يمكنك التحقق من تثبيت Npm عن طريق فتح سطر الأوامر (Command Prompt أو Terminal) وكتابة الأمر التالي:

Admin (talk)bash npm -v Admin (talk)

إذا تم تثبيت Npm بشكل صحيح، فسوف يعرض هذا الأمر رقم الإصدار. إذا لم يتم تثبيت Npm، يمكنك تنزيله من الموقع الرسمي لـ Node.js: [1](https://nodejs.org/en/download/)

الأوامر الأساسية في Npm

Npm يوفر مجموعة واسعة من الأوامر. إليك بعض الأوامر الأساسية التي ستستخدمها بشكل متكرر:

npm init: يقوم بإنشاء ملف package.json جديد في دليل المشروع الحالي. سيطلب منك Npm بعض المعلومات حول مشروعك، مثل الاسم، الإصدار، الوصف، ونقطة الدخول. يمكنك قبول القيم الافتراضية أو إدخال قيم مخصصة.
npm install <package-name>: يقوم بتثبيت الحزمة المحددة وإضافتها إلى قائمة التبعيات في ملف package.json. على سبيل المثال، لتثبيت حزمة lodash:

   Admin (talk)bash
   npm install lodash
   Admin (talk)

   سيقوم Npm بتنزيل الحزمة وتثبيتها في مجلد node_modules داخل دليل المشروع.

npm install -g <package-name>: يقوم بتثبيت الحزمة عالميًا. هذا يعني أن الحزمة ستكون متاحة للاستخدام في أي مشروع على جهازك. يستخدم هذا الخيار بشكل أساسي للأدوات التي تستخدمها بشكل متكرر.
npm uninstall <package-name>: يقوم بإزالة الحزمة المحددة من المشروع وإزالتها من قائمة التبعيات في ملف package.json.
npm update: يقوم بتحديث جميع الحزم المثبتة في مشروعك إلى أحدث إصداراتها المتوافقة مع التبعيات المحددة في ملف package.json.
npm start: يقوم بتشغيل النص البرمجي المحدد في ملف package.json تحت المفتاح "start". عادةً ما يستخدم هذا الأمر لتشغيل تطبيق Node.js.
npm run <script-name>: يقوم بتشغيل النص البرمجي المحدد في ملف package.json تحت المفتاح المحدد. على سبيل المثال، إذا كان لديك نص برمجي يسمى "test" في ملف package.json:

   Admin (talk)bash
   npm run test
   Admin (talk)

npm search <keyword>: يقوم بالبحث عن الحزم المتعلقة بالكلمة الرئيسية المحددة في سجل Npm.

ملف package.json

ملف package.json هو قلب أي مشروع Node.js أو جافاسكربت يستخدم Npm. إليك بعض الحقول الرئيسية في ملف package.json:

name: اسم الحزمة.
version: إصدار الحزمة.
description: وصف موجز للحزمة.
main: نقطة الدخول إلى الحزمة.
scripts: مجموعة من النصوص البرمجية التي يمكن تشغيلها باستخدام Npm.
dependencies: قائمة بالحزم التي يعتمد عليها مشروعك في وقت التشغيل.
devDependencies: قائمة بالحزم التي يعتمد عليها مشروعك فقط في التطوير (مثل أدوات الاختبار).
author: اسم مؤلف الحزمة.
license: ترخيص الحزمة.

أمثلة على استخدامات scripts في package.json
Script Name	Command
start	"node index.js"
test	"jest"
build	"webpack"

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

إدارة التبعيات هي أحد أهم جوانب استخدام Npm. Npm يسمح لك بتحديد التبعيات التي يحتاجها مشروعك، ويقوم بتثبيتها تلقائيًا عند تشغيل الأمر npm install. هناك طريقتان لتحديد التبعيات:

التبعية الثابتة (Fixed Dependency): تحدد إصدارًا دقيقًا من الحزمة. على سبيل المثال:

   Admin (talk)json
   "dependencies": {
     "lodash": "4.17.21"
   }
   Admin (talk)

   هذا يضمن أن مشروعك سيستخدم دائمًا الإصدار المحدد من lodash.

التبعية النطاقية (Range Dependency): تحدد نطاقًا من الإصدارات المسموح بها. على سبيل المثال:

   Admin (talk)json
   "dependencies": {
     "lodash": "^4.17.0"
   }
   Admin (talk)

   يشير الرمز "^" إلى أن Npm يمكنه تثبيت أي إصدار من lodash أكبر من أو يساوي 4.17.0 ولكن أقل من 5.0.0.  هذا يسمح لك بالحصول على إصلاحات الأخطاء والميزات الجديدة دون المخاطرة بتغييرات غير متوافقة.

فهم SemVer (Semantic Versioning)

يستخدم Npm نظام SemVer لتحديد إصدارات الحزم. يتكون رقم الإصدار من ثلاثة أجزاء: MAJOR.MINOR.PATCH.

MAJOR: تغييرات غير متوافقة مع الإصدارات السابقة.
MINOR: إضافة ميزات جديدة متوافقة مع الإصدارات السابقة.
PATCH: إصلاحات الأخطاء المتوافقة مع الإصدارات السابقة.

فهم SemVer يساعدك على اختيار التبعيات المناسبة لمشروعك.

استخدام Npm مع الخيارات الثنائية

على الرغم من أن Npm يركز على حزم جافاسكربت، إلا أن مبادئه يمكن تطبيقها على فهم المخاطر وإدارة التبعيات في استراتيجيات الخيارات الثنائية. فكر في كل استراتيجية تداول كـ "حزمة" تعتمد على مؤشرات فنية معينة (مثل المتوسطات المتحركة، RSI، MACD) كـ "تبعيات".

**تحليل التبعيات:** مثلما تفحص package.json للتحقق من التبعيات، يجب عليك تحليل استراتيجية التداول لتحديد المؤشرات الفنية التي تعتمد عليها. هل الاستراتيجية تعتمد بشكل كبير على مؤشر واحد؟ هذا يشبه الاعتماد على تبعية واحدة، مما يزيد من المخاطر.
**إدارة الإصدارات:** تتغير المؤشرات الفنية (أو "إصدارات" البيانات) بمرور الوقت. قد يؤدي استخدام إعدادات قديمة أو غير مناسبة للمؤشر إلى نتائج غير دقيقة. يجب عليك تحديث إعدادات المؤشرات بانتظام (مثل npm update) لضمان دقتها.
**التبعية النطاقية:** بدلاً من الاعتماد على قيم ثابتة للمؤشرات، يمكنك تحديد نطاقات مقبولة. على سبيل المثال، بدلاً من التداول فقط عندما يكون RSI يساوي 70، يمكنك التداول عندما يكون RSI بين 65 و 75. هذا يوفر مرونة أكبر ويقلل من المخاطر.

- استراتيجيات الخيارات الثنائية ذات الصلة:**

استراتيجية 60 ثانية : تعتمد على تحليل سريع للاتجاهات.
استراتيجية مارتينجال : استراتيجية إدارة المخاطر ولكنها عالية الخطورة.
استراتيجية القنوات : تعتمد على تحديد القنوات السعرية.
استراتيجية الاختراق : تعتمد على توقع اختراق مستويات الدعم والمقاومة.
استراتيجية التداول العكسي : تعتمد على توقع انعكاس الاتجاهات.
تحليل حجم التداول : فهم تأثير حجم التداول على الأسعار.
تحليل الاتجاهات : تحديد الاتجاهات السعرية الرئيسية.
مؤشر بولينجر باندز : قياس تقلبات السوق.
مؤشر ستوكاستيك : تحديد مناطق ذروة الشراء والبيع.
مؤشر ويليامز %R : مشابه لمؤشر ستوكاستيك.
استراتيجية المتوسطات المتحركة المتقاطعة : استخدام المتوسطات المتحركة لتحديد نقاط الدخول والخروج.
استراتيجية الدعم والمقاومة : تحديد مستويات الدعم والمقاومة الرئيسية.
استراتيجية أنماط الشموع اليابانية : تحليل أنماط الشموع اليابانية للتنبؤ بحركة الأسعار.
استراتيجية فيبوناتشي : استخدام مستويات فيبوناتشي لتحديد نقاط الدخول والخروج.
استراتيجية إيليوت ويف : تحليل أنماط الموجات السعرية.
استراتيجية التداول بناءً على الأخبار الاقتصادية : التداول بناءً على الأحداث الاقتصادية الهامة.
استراتيجية التداول الخوارزمي : استخدام الخوارزميات لتنفيذ الصفقات تلقائيًا.
تحليل فجوة السعر : تحديد فرص التداول بناءً على فجوات الأسعار.
استراتيجية التداول المتأرجح : التداول على تقلبات الأسعار قصيرة الأجل.
استراتيجية التداول اليومي : التداول على تقلبات الأسعار اليومية.
استراتيجية التداول طويل الأجل : التداول على المدى الطويل.
استراتيجية التداول بناءً على التحليل الأساسي : التداول بناءً على العوامل الاقتصادية والمالية.
استراتيجية التداول بناءً على التحليل الفني : التداول بناءً على الرسوم البيانية والمؤشرات الفنية.
استراتيجية التداول بناءً على إدارة المخاطر : التداول مع التركيز على تقليل المخاطر.

موارد إضافية

وثائق Npm الرسمية: [2](https://docs.npmjs.com/)
دليل Npm للمبتدئين: [3](https://www.freecodecamp.org/news/npm-tutorial-for-beginners/)

الخلاصة

Npm هو أداة قوية تسهل إدارة الحزم في مشاريع جافاسكربت. من خلال فهم الأوامر الأساسية، وملف package.json، ومفاهيم إدارة التبعيات، يمكنك الاستفادة الكاملة من Npm وتسريع عملية التطوير. تذكر أن المبادئ الأساسية لإدارة التبعيات يمكن تطبيقها على مجالات أخرى، مثل استراتيجيات الخيارات الثنائية، لتقليل المخاطر وتحسين الأداء. Node.js Package.json SemVer JavaScript Command Line Interface Dependencies npm init npm install npm uninstall npm update npm run npm search Node modules الخيارات الثنائية ```

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

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

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

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