כללי ווידג׳טים: גדלים, מגבלות ביצועים וקודי בדיקה

גדלים, סוגי קבצים, מגבלות ביצועים וכל קוד שבדיקה יכולה להיכשל בו.

8 דק׳ קריאה עודכן ב-4 בנוב׳ 2026

ווידג׳ט רץ באוברליי לצד כל השאר, לרוב במחשבים איטיים יותר. לכן חלות מגבלות קבועות. Livedeck משתמשת באותם מספרים בשלושה מקומות: כאן בתיעוד, בבדיקה האוטומטית לפני האישור ובאוברליי במהלך ה-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 גם מכבה את התכונות האלה בתוך הווידג׳ט.
  • סקריפטים, מטפלי אירועים או foreignObject בקובצי SVG
  • קובצי ZIP מוצפנים, קישורים סימבוליים וארכיונים בתוך הארכיון

האדמין גם רואה התראות על eval,‏ new Function,‏ WebAssembly,‏ WebSockets, גישה לאחסון או לחלון האוברליי, דפוסי כרייה וקוד מוסתר או מכווץ. התראות לא מכשילות את הבדיקה מיד, אבל צריכה להיות להן סיבה טובה. צרפו לקוד מכווץ את המקורות הקריאים בתיקיית src/‎.

manifest.json, תיקיית src/‎ וקובצי ‎.md או ‎.txt מיועדים לבדיקה בלבד. Livedeck אף פעם לא מגישה אותם לאוברליי, כך שהקוד שלכם לא יכול לטעון אותם. כל משתמש מקבל את הווידג׳ט בכתובת משלו.

מגבלות ביצועים

מוכן אחרי טעינת העמוד

3000 ms

טעינת העמוד במהלך ה-LIVE

15,000 ms

מעבד בלי אירועים (ממוצע)

2 %

מעבד עם המון אירועים (ממוצע)

15 %

זיכרון (JavaScript)

64 MB

אלמנטים בעמוד

3000

החסימה הארוכה ביותר ברצף

200 ms

במהלך ה-LIVE

  • האוברליי בודק כל 2000 ms. 3 תשובות ברצף שאיטיות מ-1000 ms, או 6000 ms בלי שום תשובה, מכבות את הווידג׳ט.
  • כשהאוברליי עצמו נתקע (למשל כי הכרטיסייה הייתה ברקע), זה אף פעם לא נזקף לחובת הווידג׳ט שלכם.
  • ווידג׳ט שכובה נשאר כבוי עד הטעינה הבאה. העורך יציג אז "הווידג׳ט נעצר".’,’key’:’’
טיפ: שמרו על דף קטן: הסירו אלמנטים ישנים (ערכת הפתיחה מציגה לכל היותר 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

קישור סימבולי בחבילה.

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

הווידג׳ט לא דיווח ל-overlay אחרי הטעינה. בדרך כלל חסר <script src="/sdk/v1.js"> או שהדף לא מסיים להיטען.

perf_ready_slow

מוכן מאוחר מדי: יותר מ-3000 ms אחרי טעינת הדף.

perf_unresponsive

לא עונה לבדיקה של ה-overlay, או עונה לאט מדי (הקוד חוסם את הדפדפן).

perf_navigated

הווידג׳ט ניווט לדף אחר או טען מחדש את הדף שלו.

perf_flood

הווידג׳ט שולח ל-overlay יותר מדי הודעות.

perf_idle_cpu

יותר מ-2 % CPU כשלא קורה כלום.

perf_storm_cpu

יותר מ-15 % CPU עם הרבה אירועים.

perf_heap

יותר מ-64 MB זיכרון.

perf_dom

יותר מ-3000 אלמנטים בדף.

perf_long_task

חוסם את הדפדפן ליותר מ-200 ms בכל פעם.

network_attempt

מנסה לטעון משהו מאתר אחר (שם השרת מוצג).

runtime_errors

רק אזהרה, לא סיבה לכישלון: שגיאות JavaScript במהלך הבדיקה. האדמין רואה את הראשונה.

המאמר הזה עזר לך?