بيان مورد الويب

معرّف المخطط: web-resource-manifest@1 المخطط القابل للقراءة آليًا: web-resource-manifest.schema.json

الوصف المرجعي للبيانات الوصفية لـ مورد ويب (القسم 6.15): وهو ملف تطبيق — JavaScript أو CSS أو HTML أو JSON أو XML أو نص أو صورة — مخزَّن في قاعدة بيانات المنصة ومحزَّم بوصفه عنصر حل من الدرجة الأولى، فينتقل مع الحل بدلًا من جلبه من مضيف خارجي. أما بايتات الملف فتنتقل منفصلةً (مضمَّنة داخل حزمة الحل)؛ وهذا البيان هو البيانات الوصفية، ويجري التحقق منه بالطريقة نفسها سواء أُنشئ المورد عبر Admin Control Center، أو أُرسل باستدعاء API مباشر، أو وُلِّد بمساعد ذكاء اصطناعي، أو جاء داخل استيراد حل — وهي قاعدة مسار التحقق الواحد (القسم 6.7).

وموارد الويب ليست Object Storage عن قصد: فـ Object Storage هو مخزن الكائنات المنفصل للأحجام الكبيرة من ملفات التشغيل والمستخدمين، بينما مورد الويب ملف تطبيق صغير يُحفظ في قاعدة البيانات ويُصدَّر إصداره مع الحل. ويفرض حدٌّ أقصى للحجم لكل مورد هذا الفصل.

الشكل

الحقل	النوع	مطلوب	ملاحظات
logicalName	string	نعم	مسبوق ببادئة الناشر، وشبيه بالمسار (مثل par_/dashboard/remoteEntry.js). بأحرف صغيرة؛ ولا يُسمح إلا بالحروف والأرقام و_ و. و/ و-. ويتيح جزء المسار لملفات الحزمة الكثيرة أن تشترك في قاعدة واحدة.
displayName	string	نعم	اسم مقروء يظهر في شبكة موارد الويب.
description	string | null	لا	وصف قصير.
type	string	نعم	واحد من JavaScript، Css، Html، Json، Xml، PlainText، Png، Jpeg، Gif، Svg، Ico، Binary. ويحدد Content-Type المُقدَّم وما إذا كان الملف نصيًا (قابلًا للتحرير ضمن الصفحة) أو ثنائيًا (يُرفع فقط).
contentHash	string	نعم	تجزئة SHA-256 لبايتات الملف بصيغة ست عشرية صغيرة. وإعادة استيراد محتوى مطابق عملية عديمة الأثر، والاستجابة المُقدَّمة قابلة للتخزين المؤقت بوصفها ثابتة لكل تجزئة.
sizeBytes	integer	نعم	حجم بايتات الملف (‏≥ 0).

أين يجري التحقق منه

• الإنشاء — تتحقق طبقة التطبيق من البيان مقابل web-resource-manifest@1، وتفرض أن يبدأ logicalName ببادئة الناشر المالك، وترفض المحتوى الذي يتجاوز الحد الأقصى للحجم، قبل تخزين البايتات.
• استيراد الحل — يُعاد التحقق من كل بيان مورد ويب مضمَّن في حزمة الحل مقابل المخطط نفسه قبل تخزين المورد في البيئة الهدف.

التقديم

تقدّم المنصة بايتات مورد الويب من أصلها الخاص، فتضبط Content-Type انطلاقًا من type وتعيد contentHash بوصفه ETag قويًا. والتقديم من 'self' هو ما يتيح تحميل حزمة تطبيق مخصص أو عنصر تحكم مخصص تحت سياسة CSP صارمة دون إدراج أصل خارجي في قائمة السماح (القسم 6.15، "وضع التحزيم").

ذات صلة

• بيان التطبيق المخصص — في وضع التحزيم، تُخزَّن مخرجات بناء التطبيق المخصص بوصفها موارد ويب ويشير remoteEntryUrl الخاص به إلى المسار الذي تقدّمه المنصة.
• حزمة الحل — كيف تنتقل العناصر (ومنها موارد الويب) بين البيئات.