قواعد الـ widget: الأحجام وحدود الأداء ورموز الفحص

الأحجام وأنواع الملفات وحدود الأداء وكل رمز قد يفشل به الفحص.

قراءة في 8 دقيقة آخر تحديث 4 نوفمبر 2026

يعمل الـ widget داخل الـ overlay بجانب كل شيء آخر، وغالبًا على أجهزة أبطأ. لذلك تنطبق حدود ثابتة. يستخدم Livedeck الأرقام نفسها في ثلاثة أماكن: هنا في التوثيق، وفي الاختبار التلقائي قبل الموافقة، وفي الـ overlay أثناء LIVE.

الحزمة

ملف 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

أثناء LIVE

  • يتحقق الـ overlay كل 2000 ms. ثلاث استجابات متتالية أبطأ من 1000 ms، أو 6000 ms دون أي استجابة، تؤدي إلى إيقاف الـ widget.
  • إذا كان الـ overlay نفسه متجمّدًا (مثلًا لأن علامة التبويب كانت في الخلفية)، فلا يُحتسب ذلك أبدًا ضد الـ widget.
  • الـwidget الذي أُوقف يبقى متوقفًا حتى إعادة التحميل التالية. ويعرض المحرر عندها "Widget stopped".
نصيحة: اجعل الصفحة خفيفة: احذف العناصر القديمة (حزمة البداية تعرض maxCards بطاقة كحد أقصى)، واستخدم حركات CSS بدل حلقات JavaScript، ولا تشغّل مؤقتات عندما لا يحدث شيء.

رموز الفحص

عند فشل الفحص، يعرض المحرر أو استوديو البائع قائمة بالأسباب. وتجد هنا كل رمز منها.

ملف 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).

اختبار تلقائي

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 أثناء الاختبار. يرى المشرف أول خطأ منها.

هل كانت هذه المقالة مفيدة؟