npm ERR! code EBADENGINE (unsupported engine)
npm ERR! code EBADENGINE (unsupported engine)
الحزمة المثبَّتة تتطلّب إصدار Node أو npm لا يطابق بيئتك.
ماذا يعني
الحزمة المثبَّتة تتطلّب إصدار Node أو npm لا يطابق بيئتك.
السبب المحتمل
حقل "engines" في حزمة يحدّد نطاق Node/npm خارج نطاقه بيئة التشغيل الحالية.
كيفية إصلاحه
انتقل إلى إصدار Node متوافق (nvm install/use الإصدار المطلوب) بدلًا من تجاهله. كتجاوز مؤقت يمكنك ضبط engine-strict=false أو استخدام --force.
أخطاء Node.js و npm أخرى
حول البحث عن رموز الأخطاء
أداة البحث عن رموز الأخطاء هي دليل قابل للبحث يضم أكثر من 200 رسالة ورمز خطأ شائع موزعة على 12 فئة: رموز حالة HTTP، أخطاء Windows، أخطاء المتصفح والشبكة، JavaScript، Python، PHP، Node.js وnpm، Java، MySQL، Git، أخطاء shell في Linux ورموز البريد الإلكتروني/SMTP. كل مدخل مكتوب بلغة بسيطة لتسهيل استكشاف الأخطاء وإصلاحها بسرعة.
يُشرح كل خطأ في ثلاثة أجزاء: ماذا تعني الرسالة فعلياً، وما هو سببها الشائع، والخطوات العملية لإصلاحها. هذا التنظيم يحوّل نصاً غامضاً مثل ERR_CONNECTION_REFUSED أو 0x80070005 إلى قائمة إجراءات واضحة بدلاً من التخمين.
يمكنك تصفية القائمة حسب الفئة، والبحث برمز الخطأ أو الثابت أو جزء من الرسالة، ونسخ أي رمز بنقرة واحدة. لكل خطأ أيضاً صفحته المخصصة مع أخطاء ذات صلة من نفس الفئة، بحيث يمكنك حفظ رابط مباشر للحل أو مشاركته.
كيفية استخدام البحث عن رموز الأخطاء
- اكتب رمز الخطأ أو الرسالة في مربع البحث — مثلاً 404 أو ERR_NAME_NOT_RESOLVED أو 0x80070005.
- ضيّق النتائج باستخدام فلتر الفئة (HTTP، Windows، JavaScript، MySQL وغيرها) إذا أعاد البحث عدداً كبيراً من النتائج.
- افتح المدخل المطابق لقراءة معناه وسببه المحتمل وكيفية إصلاحه.
- استخدم زر النسخ للحصول على الرمز الدقيق لتضمينه في تقرير خلل أو تذكرة دعم.
- راجع قسم الأخطاء ذات الصلة لمعرفة أخطاء أخرى من نفس الفئة.