قواعد الـ widget: الأحجام وحدود الأداء ورموز الفحص
الأحجام وأنواع الملفات وحدود الأداء وكل رمز قد يفشل به الفحص.
يعمل الـ widget داخل الـ overlay بجانب كل شيء آخر، وغالبًا على أجهزة أبطأ. لذلك تنطبق حدود ثابتة. يستخدم Livedeck الأرقام نفسها في ثلاثة أماكن: هنا في التوثيق، وفي الاختبار التلقائي قبل الموافقة، وفي الـ overlay أثناء LIVE.
الحزمة
ملف ZIP
5 MB
الإجمالي بعد فك الضغط
5 MB
ملف واحد
2 MB
الملفات
200
طول المسار
180 حرفًا
عمق المجلدات
8
manifest.json
64 KB
| الحد | القيمة |
|---|---|
| ملف ZIP | 5 MB |
| الإجمالي بعد فك الضغط | 5 MB |
| ملف واحد | 2 MB |
| الملفات | 200 |
| طول المسار | 180 حرفًا |
| عمق المجلدات | 8 |
| manifest.json | 64 KB |
أنواع الملفات المسموحة: html وjs وmjs وcss وjson وsvg وtxt وmd وpng وjpg وjpeg وwebp وgif وmp3 وogg وwav وwoff2. يجب أن تكون الملفات النصية بترميز UTF-8. ويجب أن تكون الصور والأصوات والخطوط فعلًا من النوع الذي يدل عليه امتدادها.
ما هو غير مسموح
- عناوين مواقع أخرى في HTML أو CSS أو JavaScript أو SVG أو JSON (http:// أو https:// أو ws:// أو wss:// أو //host). العناوين داخل التعليقات لا تُفشل الفحص، لكن المشرف يراها.
- iframe وframe وobject وembed وportal وbase وmeta refresh في HTML
- WebRTC (RTCPeerConnection أو خوادم STUN أو TURN)، والإطارات من JavaScript (createElement("iframe") أو "<iframe" داخل النصوص)، وتلميحات الاتصال مثل dns-prefetch أو preconnect. كما يعطّل Livedeck هذه الميزات داخل الـ widget.
- السكربتات أو معالجات الأحداث أو foreignObject في ملفات SVG
- ملفات ZIP المشفّرة والروابط الرمزية والأرشيفات داخل الأرشيف
يرى المشرف أيضًا تنبيهات حول eval وnew Function وWebAssembly وWebSockets والوصول إلى التخزين أو نافذة الـ overlay وأنماط التعدين والكود المُبهم أو المصغّر. التنبيهات لا تُفشل الفحص فورًا، لكنها تحتاج إلى سبب وجيه. أرفق الكود المصغّر مع المصادر المقروءة في مجلد src/.
ملف manifest.json ومجلد src/ وملفات .md أو .txt مخصصة للمراجعة فقط. لا يقدّمها Livedeck أبدًا للـ overlay، لذا لا يمكن لكودك تحميلها. يحصل كل مستخدم على الـ widget عبر عنوان خاص به.
حدود الأداء
الجاهزية بعد تحميل الصفحة
3000 ms
تحميل الصفحة أثناء LIVE
15,000 ms
المعالج بدون أحداث (المتوسط)
2 %
المعالج مع أحداث كثيرة جدًا (المتوسط)
15 %
الذاكرة (JavaScript)
64 MB
العناصر في الصفحة
3000
أطول تجميد متواصل
200 ms
| القياس | الحد |
|---|---|
| الجاهزية بعد تحميل الصفحة | 3000 ms |
| تحميل الصفحة أثناء LIVE | 15,000 ms |
| المعالج بدون أحداث (المتوسط) | 2 % |
| المعالج مع أحداث كثيرة جدًا (المتوسط) | 15 % |
| الذاكرة (JavaScript) | 64 MB |
| العناصر في الصفحة | 3000 |
| أطول تجميد متواصل | 200 ms |
أثناء LIVE
- يتحقق الـ overlay كل 2000 ms. ثلاث استجابات متتالية أبطأ من 1000 ms، أو 6000 ms دون أي استجابة، تؤدي إلى إيقاف الـ widget.
- إذا كان الـ overlay نفسه متجمّدًا (مثلًا لأن علامة التبويب كانت في الخلفية)، فلا يُحتسب ذلك أبدًا ضد الـ widget.
- الـwidget الذي أُوقف يبقى متوقفًا حتى إعادة التحميل التالية. ويعرض المحرر عندها "Widget stopped".
رموز الفحص
عند فشل الفحص، يعرض المحرر أو استوديو البائع قائمة بالأسباب. وتجد هنا كل رمز منها.
ملف ZIP
zip_too_large
ملف ZIP أكبر من 5 MB.
zip_total_too_large
أكبر من 5 MB بعد فك الضغط.
zip_file_too_large
أحد الملفات أكبر من 2 MB.
zip_too_many_files
أكثر من 200 ملف.
zip_not_zip
ليس ملف ZIP، أو أنه فارغ.
zip_multi_disk
مقسّم إلى عدة أجزاء. اضغط كل شيء في ملف واحد.
zip64_unsupported
ZIP64 غير مدعوم.
zip_trailing_data
توجد بيانات إضافية بعد نهاية ملف ZIP.
zip_corrupt
ملف ZIP تالف.
zip_encrypted
ملف ZIP محمي بكلمة مرور.
zip_unsupported_method
طريقة الضغط غير مدعومة. المسموح: Stored (بدون ضغط) وDeflate (الافتراضية).
zip_header_mismatch
الأرشيف يناقض نفسه.
zip_overlap
توجد ملفات متداخلة داخل الأرشيف.
zip_crc_mismatch
المجموع الاختباري خاطئ، أحد الملفات تالف.
zip_symlink
رابط رمزي (symbolic link) في الحزمة.
zip_bad_name
اسم ملف غير صالح: أحرف غير ASCII بدون UTF-8، أو ../، أو مسارات مطلقة، أو أحرف خاصة، أو أطول من 180 حرفًا، أو أعمق من 8 مجلدات.
zip_duplicate_name
ملف مكرر مرتين في الأرشيف.
zip_nested_archive
أرشيف داخل الأرشيف (مثل ZIP داخل ZIP).
| الرمز | المعنى |
|---|---|
| zip_too_large | ملف ZIP أكبر من 5 MB. |
| zip_total_too_large | أكبر من 5 MB بعد فك الضغط. |
| zip_file_too_large | أحد الملفات أكبر من 2 MB. |
| zip_too_many_files | أكثر من 200 ملف. |
| zip_not_zip | ليس ملف ZIP، أو أنه فارغ. |
| zip_multi_disk | مقسّم إلى عدة أجزاء. اضغط كل شيء في ملف واحد. |
| zip64_unsupported | ZIP64 غير مدعوم. |
| zip_trailing_data | توجد بيانات إضافية بعد نهاية ملف ZIP. |
| zip_corrupt | ملف ZIP تالف. |
| zip_encrypted | ملف ZIP محمي بكلمة مرور. |
| zip_unsupported_method | طريقة الضغط غير مدعومة. المسموح: Stored (بدون ضغط) وDeflate (الافتراضية). |
| zip_header_mismatch | الأرشيف يناقض نفسه. |
| zip_overlap | توجد ملفات متداخلة داخل الأرشيف. |
| zip_crc_mismatch | المجموع الاختباري خاطئ، أحد الملفات تالف. |
| zip_symlink | رابط رمزي (symbolic link) في الحزمة. |
| zip_bad_name | اسم ملف غير صالح: أحرف غير ASCII بدون UTF-8، أو ../، أو مسارات مطلقة، أو أحرف خاصة، أو أطول من 180 حرفًا، أو أعمق من 8 مجلدات. |
| zip_duplicate_name | ملف مكرر مرتين في الأرشيف. |
| zip_nested_archive | أرشيف داخل الأرشيف (مثل ZIP داخل ZIP). |
الملفات والمحتوى
manifest_missing
ملف manifest.json مفقود. يجب أن يكون في أعلى ملف ZIP أو داخل مجلده الوحيد.
manifest_invalid
ملف manifest.json غير صالح. الأخطاء مذكورة أسفله (الرموز في "مرجع manifest.json").
entry_missing
ملف البدء المحدد في entry غير موجود في الحزمة.
file_type_not_allowed
نوع الملف هذا غير مسموح.
file_content_mismatch
المحتوى لا يطابق الامتداد (مثل ملف JPG باسم .png).
file_not_utf8
الملف النصي غير محفوظ بترميز UTF-8.
file_empty
الملف فارغ.
external_reference
يحتوي الملف على عنوان موقع آخر (مع رقم السطر).
forbidden_markup
HTML غير مسموح (iframe أو frame أو object أو embed أو portal أو base أو meta refresh) أو سكربت داخل ملف SVG.
forbidden_api
كود يتحايل على حظر الاتصال بالشبكة: WebRTC (RTCPeerConnection، STUN/TURN)، أو إطارات من JavaScript (createElement("iframe")، أو "<iframe" داخل النصوص)، أو تلميحات الاتصال (dns-prefetch، preconnect، prerender، prefetch).
| الرمز | المعنى |
|---|---|
| manifest_missing | ملف manifest.json مفقود. يجب أن يكون في أعلى ملف ZIP أو داخل مجلده الوحيد. |
| manifest_invalid | ملف manifest.json غير صالح. الأخطاء مذكورة أسفله (الرموز في "مرجع manifest.json"). |
| entry_missing | ملف البدء المحدد في entry غير موجود في الحزمة. |
| file_type_not_allowed | نوع الملف هذا غير مسموح. |
| file_content_mismatch | المحتوى لا يطابق الامتداد (مثل ملف JPG باسم .png). |
| file_not_utf8 | الملف النصي غير محفوظ بترميز UTF-8. |
| file_empty | الملف فارغ. |
| external_reference | يحتوي الملف على عنوان موقع آخر (مع رقم السطر). |
| forbidden_markup | HTML غير مسموح (iframe أو frame أو object أو embed أو portal أو base أو meta refresh) أو سكربت داخل ملف SVG. |
| forbidden_api | كود يتحايل على حظر الاتصال بالشبكة: WebRTC (RTCPeerConnection، STUN/TURN)، أو إطارات من JavaScript (createElement("iframe")، أو "<iframe" داخل النصوص)، أو تلميحات الاتصال (dns-prefetch، preconnect، prerender، prefetch). |
اختبار تلقائي
test_failed تعني أن الاختبار التلقائي تجاوز حدًا واحدًا على الأقل. الأسباب مذكورة أسفله، كل منها مع القيمة المقاسة والحد.
perf_no_ready
لم يتواصل الـwidget مع الـoverlay بعد التحميل. غالبًا ينقص <script src="/sdk/v1.js"> أو لا تكتمل الصفحة في التحميل أبدًا.
perf_ready_slow
جاهز متأخرًا: أكثر من 3000 ms بعد تحميل الصفحة.
perf_unresponsive
لا يستجيب لفحص الـoverlay، أو يستجيب ببطء شديد (الكود يجمّد المتصفح).
perf_navigated
انتقل الـwidget إلى صفحة أخرى أو أعاد تحميل صفحته.
perf_flood
يرسل الـwidget رسائل كثيرة جدًا إلى الـoverlay.
perf_idle_cpu
أكثر من 2 % من المعالج عندما لا يحدث شيء.
perf_storm_cpu
أكثر من 15 % من المعالج مع أحداث كثيرة.
perf_heap
أكثر من 64 MB من الذاكرة.
perf_dom
أكثر من 3000 عنصر في الصفحة.
perf_long_task
يجمّد المتصفح لأكثر من 200 ms في المرة الواحدة.
network_attempt
يحاول تحميل شيء من موقع آخر (يظهر اسم المضيف).
runtime_errors
مجرد تنبيه وليس سببًا للفشل: أخطاء JavaScript أثناء الاختبار. يرى المشرف أول خطأ منها.
| الرمز | المعنى |
|---|---|
| perf_no_ready | لم يتواصل الـwidget مع الـoverlay بعد التحميل. غالبًا ينقص <script src="/sdk/v1.js"> أو لا تكتمل الصفحة في التحميل أبدًا. |
| perf_ready_slow | جاهز متأخرًا: أكثر من 3000 ms بعد تحميل الصفحة. |
| perf_unresponsive | لا يستجيب لفحص الـoverlay، أو يستجيب ببطء شديد (الكود يجمّد المتصفح). |
| perf_navigated | انتقل الـwidget إلى صفحة أخرى أو أعاد تحميل صفحته. |
| perf_flood | يرسل الـwidget رسائل كثيرة جدًا إلى الـoverlay. |
| perf_idle_cpu | أكثر من 2 % من المعالج عندما لا يحدث شيء. |
| perf_storm_cpu | أكثر من 15 % من المعالج مع أحداث كثيرة. |
| perf_heap | أكثر من 64 MB من الذاكرة. |
| perf_dom | أكثر من 3000 عنصر في الصفحة. |
| perf_long_task | يجمّد المتصفح لأكثر من 200 ms في المرة الواحدة. |
| network_attempt | يحاول تحميل شيء من موقع آخر (يظهر اسم المضيف). |
| runtime_errors | مجرد تنبيه وليس سببًا للفشل: أخطاء JavaScript أثناء الاختبار. يرى المشرف أول خطأ منها. |
هل كانت هذه المقالة مفيدة؟