وقت القراءة المقدر : 4 min · تاريخ النشر
ربط كل تبعية لغرضها
المخزون المكونات المباشرة والتبعيات التي تجلبها الأدوات. سجل الإصدار المثبت أو السجل أو المورد والميزة المدعومة ومالك التحديث. قم بتضمين المكونات الإضافية CMS بدلاً من الحزم التي يديرها المطور فقط.
اطرح سؤالاً مبسطًا: إذا اختفت الميزة ، فما هي الرحلة المفيدة التي ستضيع؟ يضيف مكون مثبت ولكنه منسي العمل دون تحديد قيمته. ضع في اعتبارك الإزالة فقط بعد التحقق من المحتوى والبيانات والمكونات التابعة.
تقييم تنبيه مقابل المشروع الفعلي
قارن الحزمة المتأثرة والإصدار بالمخزون. افحص شروط التعرض والإصلاح المعلن والتبعيات ذات الصلة. لا يصف التنبيه البنية بأكملها ، وغياب التنبيهات ليس ضمانًا أمنيًا.
توثيق سبب للأولوية: الوظيفة المكشوفة أو البيانات المتأثرة أو الاستغلال المعروف أو التغيير المطلوب. عندما يكون الموقف غير مؤكد ، قم بإشراك مراجع مؤهل بدلاً من استبدال عدم اليقين بنتيجة مقدمة على أنها يقين.
تحضير تحديث قابل للتكرار
احتفظ بالملفات التي تصف الإصدارات التي تم حلها وقم ببناء الخطوات. استخدم بيئة اختبار تمثيلية وبيانات تركيبية ونسخة احتياطية مناسبة. قارن الرحلات المتأثرة مثل البحث أو النماذج أو الخروج أو الإدارة وفقًا للمكون.
يربط مصدر NPM حزمة منشورة بمعلومات المصدر والبناء ؛ لا تشهد أن العبوة آمنة. راجع الأدلة المتاحة دون التعامل مع المصدر على أنه توصية تركيب تلقائي.
مثال افتراضي: يُصرح عن المكوّن DEMO-PKG بالنطاق ^2.4.0، لكن ملف تثبيت الإصدارات ومرجع ناتج البناء المنشور يشيران إلى 2.4.1. يشمل التنبيه المصطنع للتمرين الإصدارات من 2.4.0 إلى 2.4.2 ويقترح 2.4.3. يسمح التصريح أصلًا بهذا التصحيح ضمن الإصدارات المستقرة المتوافقة؛ لكنه لا يثبت اختياره أو بناءه أو نشره.
في npm يستخدم npm ci ملف التثبيت الموجود ولا يحدّثه لاختيار تصحيح أحدث. قارن التصريح والإصدار المحدد وناتج البناء والإصدار المقدم فعلًا. بعد تحديث معدّ مسبقًا، يتطلب الجدول مطابقتها مع 2.4.3 واختبار المسار المعني. الإصدار والتنبيه افتراضيان، وتوافقهما لا يضمن غياب عيوب أخرى.
مرّر الجدول أفقيًا لقراءة جميع الأعمدة. باستخدام لوحة المفاتيح، انقل التركيز إلى الجدول ثم استخدم مفاتيح الأسهم.
| المرجع المفحوص | قيمة التمرين | ما يثبته |
|---|---|---|
| التصريح في ملف الوصف | إصدارات مستقرة من 2.4.0 وقبل 3.0.0 | نطاق مسموح وليس إصدارًا منشورًا |
| ملف التثبيت قبل التصحيح | 2.4.1 | الإصدار المحدد ما زال مشمولًا بالتنبيه الافتراضي |
| ناتج البناء المنشور قبل التصحيح | المرجع 2.4.1 | التصحيح 2.4.3 غير مثبت في الإنتاج بعد |
| بعد تحديث مضبوط | ملف التثبيت والبناء والناتج المقدم: 2.4.3 | مطابقة مطلوبة ثم اختبارات وظيفية وقرار النشر |
- npm : npm ci
npm، تمت مراجعته في 22 أكتوبر 2026: سلوك npm ci. DEMO-PKG والإصدارات والتنبيه سيناريو افتراضي.
- npm/node-semver : Caret Ranges
npm/node-semver، تمت مراجعته في 22 أكتوبر 2026: نطاقات الإصدارات وقواعد الإصدارات التمهيدية.
سجل النتيجة وخطة الانتعاش
سجلت الإصدارات قبل وبعد ، اجتازت الاختبارات والمناطق غير المحددة وقرار الإفراج. يجب أن يتضمن الاسترداد البيانات عندما يغير التحديث هيكله ؛ قد يكون استبدال الملفات وحدها غير كافٍ.
اختر المراجعة التالية وفقًا لدور المكون وقدرة الفريق. التسليم هو قائمة بالمكونات المفيدة مع الأصل والمالك والاختبارات والاسترداد بدلاً من جدول التغييرات الآلية العمياء.
التوثيق الأساسي: npm : Generating provenance statements.
فحص ملفات JavaScript أو CSS الخارجية ذات النسخة الثابتة.
حالة افتراضية: يحمّل مكوّن ملفًا محدد النسخة من CDN. احسب بصمته الدقيقة وتحقق من CORS. غيّر نسخة الاختبار: يجب رفضها. تحتاج البرامج التي تتغير تلقائيًا إلى استراتيجية أخرى؛ فالبصمة القديمة تمنع التحميل.
- تعمل النسخة المتوقعة وتُحجب المعدلة، مع التخطيط لتحديث البصمات.
- MDN Subresource Integrity
آلية لمقارنة مورد محمّل ببصمة متوقعة قبل استخدامه.
اتخاذ قرار في حالة ملموسة
مثال افتراضي: يصلح تحديث رئيسي مشكلة ويعطل إضافة أساسية. حدد الاستخدام والإصدارات وجهز تجربة معزولة وبديلًا؛ تثبيت الأحدث لا ينهي العمل.
سجل الاعتمادية المباشرة أو غير المباشرة والإصدار والاستخدام والمسؤول والاختبار. احفظ إعدادًا قابلًا للتكرار بلا أسرار؛ اربط التنبيه بالمكون المنشور فعلًا.
- حماية بيئة الاختبار والتحقق منها
افصل بيئة الاختبار عن الموقع العام وقيد الوصول واستخدم بيانات تجريبية. اختبر النماذج دون مراسلة عملاء حقيقيين. قبل النشر راجع المصادقة وnoindex والعناوين الأساسية والاتصالات الخارجية. لا يحل robots.txt محل حماية الوصول.
المستندات المرجعية
- MDN Subresource Integrity · مصدر تمت مراجعته
- npm : Generating provenance statements
تاريخ تحديث المحتوى
