כללי ווידג׳טים: גדלים, מגבלות ביצועים וקודי בדיקה
גדלים, סוגי קבצים, מגבלות ביצועים וכל קוד שבדיקה יכולה להיכשל בו.
ווידג׳ט רץ באוברליי לצד כל השאר, לרוב במחשבים איטיים יותר. לכן חלות מגבלות קבועות. Livedeck משתמשת באותם מספרים בשלושה מקומות: כאן בתיעוד, בבדיקה האוטומטית לפני האישור ובאוברליי במהלך ה-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 גם מכבה את התכונות האלה בתוך הווידג׳ט.
- סקריפטים, מטפלי אירועים או 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
| מדידה | מגבלה |
|---|---|
| מוכן אחרי טעינת העמוד | 3000 ms |
| טעינת העמוד במהלך ה-LIVE | 15,000 ms |
| מעבד בלי אירועים (ממוצע) | 2 % |
| מעבד עם המון אירועים (ממוצע) | 15 % |
| זיכרון (JavaScript) | 64 MB |
| אלמנטים בעמוד | 3000 |
| החסימה הארוכה ביותר ברצף | 200 ms |
במהלך ה-LIVE
- האוברליי בודק כל 2000 ms. 3 תשובות ברצף שאיטיות מ-1000 ms, או 6000 ms בלי שום תשובה, מכבות את הווידג׳ט.
- כשהאוברליי עצמו נתקע (למשל כי הכרטיסייה הייתה ברקע), זה אף פעם לא נזקף לחובת הווידג׳ט שלכם.
- ווידג׳ט שכובה נשאר כבוי עד הטעינה הבאה. העורך יציג אז "הווידג׳ט נעצר".’,’key’:’’
קודי בדיקה
כשבדיקה נכשלת, העורך או סטודיו המוכרים מציגים רשימת סיבות. כל הקודים מפורטים כאן.
קובץ 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).
| קוד | משמעות |
|---|---|
| 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).
| קוד | משמעות |
|---|---|
| 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 במהלך הבדיקה. האדמין רואה את הראשונה.
| קוד | משמעות |
|---|---|
| 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 במהלך הבדיקה. האדמין רואה את הראשונה. |
המאמר הזה עזר לך?