Widget-Regeln: Größen, Leistungsgrenzen und Prüfcodes
Größen, Dateitypen, Leistungsgrenzen und jeder Code, mit dem eine Prüfung scheitern kann.
Ein Widget läuft im Overlay neben allem anderen und oft auf schwächeren PCs. Deshalb gelten feste Obergrenzen. Dieselben Zahlen nutzt Livedeck an drei Stellen: hier in der Doku, im automatischen Test vor der Freigabe und im Overlay während des Lives.
Das Paket
ZIP-Datei
5 MB
Entpackt zusammen
5 MB
Einzelne Datei
2 MB
Dateien
200
Pfadlänge
180 Zeichen
Ordnertiefe
8
manifest.json
64 KB
| Grenze | Wert |
|---|---|
| ZIP-Datei | 5 MB |
| Entpackt zusammen | 5 MB |
| Einzelne Datei | 2 MB |
| Dateien | 200 |
| Pfadlänge | 180 Zeichen |
| Ordnertiefe | 8 |
| manifest.json | 64 KB |
Erlaubte Dateitypen: html, js, mjs, css, json, svg, txt, md, png, jpg, jpeg, webp, gif, mp3, ogg, wav, woff2. Textdateien müssen UTF-8 sein. Bilder, Töne und Schriften müssen wirklich das sein, was ihre Endung sagt.
Was nicht erlaubt ist
- Adressen anderer Seiten in HTML, CSS, JavaScript, SVG oder JSON (http://, https://, ws://, wss:// oder //host). Adressen in Kommentaren blockieren nicht, der Admin sieht sie aber.
- iframe, frame, object, embed, portal, base und meta refresh im HTML
- WebRTC (RTCPeerConnection, STUN- oder TURN-Server), Frames aus JavaScript (createElement("iframe") oder "<iframe" in Texten) und Verbindungs-Hinweise wie dns-prefetch oder preconnect. Livedeck schaltet diese Funktionen im Widget zusätzlich ab.
- Skripte, Event-Handler oder foreignObject in SVG-Dateien
- Verschlüsselte ZIP-Dateien, Verknüpfungen (Symlinks) und Archive im Archiv
Der Admin sieht außerdem Hinweise auf eval, new Function, WebAssembly, WebSockets, Zugriffe auf Speicher oder das Overlay-Fenster, Mining-Muster und verschleierten oder gepackten Code. Hinweise lassen die Prüfung nicht sofort scheitern, aber sie brauchen einen guten Grund. Gepackten Code lieferst du am besten mit lesbaren Quellen im Ordner src/ aus.
manifest.json, der Ordner src/ und .md- oder .txt-Dateien sind nur für die Prüfung da. Livedeck liefert sie nicht an das Overlay aus, dein Code kann sie also nicht laden. Jeder Nutzer bekommt dein Widget unter einer eigenen Adresse.
Leistungsgrenzen
Bereit nach dem Laden der Seite
3000 ms
Laden der Seite im Live
15.000 ms
Rechenleistung ohne Ereignisse (Durchschnitt)
2 %
Rechenleistung bei sehr vielen Ereignissen (Durchschnitt)
15 %
Arbeitsspeicher (JavaScript)
64 MB
Elemente auf der Seite
3000
Längste Blockade am Stück
200 ms
| Messung | Grenze |
|---|---|
| Bereit nach dem Laden der Seite | 3000 ms |
| Laden der Seite im Live | 15.000 ms |
| Rechenleistung ohne Ereignisse (Durchschnitt) | 2 % |
| Rechenleistung bei sehr vielen Ereignissen (Durchschnitt) | 15 % |
| Arbeitsspeicher (JavaScript) | 64 MB |
| Elemente auf der Seite | 3000 |
| Längste Blockade am Stück | 200 ms |
Im Live
- Alle 2000 ms fragt das Overlay nach. 3 Antworten in Folge langsamer als 1000 ms oder 6000 ms ganz ohne Antwort schalten das Widget ab.
- Hing das Overlay selbst (zum Beispiel weil der Tab im Hintergrund lag), zählt das nicht gegen dein Widget.
- Ein abgeschaltetes Widget bleibt bis zum Neuladen aus. Im Editor steht dann „Widget angehalten“.
Prüfcodes
Scheitert die Prüfung, siehst du im Editor oder im Verkäufer-Studio eine Liste mit Gründen. Hier steht jeder einzelne Code.
ZIP-Datei
zip_too_large
Die ZIP-Datei ist größer als 5 MB.
zip_total_too_large
Entpackt größer als 5 MB.
zip_file_too_large
Eine Datei ist größer als 2 MB.
zip_too_many_files
Mehr als 200 Dateien.
zip_not_zip
Keine ZIP-Datei oder eine leere.
zip_multi_disk
Auf mehrere Teile verteilt. Packe alles in eine Datei.
zip64_unsupported
ZIP64 wird nicht unterstützt.
zip_trailing_data
Hinter dem Ende der ZIP-Datei stehen noch Daten.
zip_corrupt
Die ZIP-Datei ist beschädigt.
zip_encrypted
Die ZIP-Datei ist mit Passwort verschlüsselt.
zip_unsupported_method
Packverfahren nicht unterstützt. Erlaubt sind ohne Kompression und Deflate (Standard).
zip_header_mismatch
Die Angaben im Archiv widersprechen sich.
zip_overlap
Dateien überlappen im Archiv.
zip_crc_mismatch
Prüfsumme falsch, eine Datei ist beschädigt.
zip_symlink
Verknüpfung (Symlink) im Paket.
zip_bad_name
Ungültiger Dateiname: Umlaute ohne UTF-8, ../, absolute Pfade, Sonderzeichen, länger als 180 Zeichen oder tiefer als 8 Ordner.
zip_duplicate_name
Eine Datei ist doppelt im Archiv.
zip_nested_archive
Ein Archiv im Archiv (zum Beispiel ZIP in ZIP).
| Code | Bedeutung |
|---|---|
| zip_too_large | Die ZIP-Datei ist größer als 5 MB. |
| zip_total_too_large | Entpackt größer als 5 MB. |
| zip_file_too_large | Eine Datei ist größer als 2 MB. |
| zip_too_many_files | Mehr als 200 Dateien. |
| zip_not_zip | Keine ZIP-Datei oder eine leere. |
| zip_multi_disk | Auf mehrere Teile verteilt. Packe alles in eine Datei. |
| zip64_unsupported | ZIP64 wird nicht unterstützt. |
| zip_trailing_data | Hinter dem Ende der ZIP-Datei stehen noch Daten. |
| zip_corrupt | Die ZIP-Datei ist beschädigt. |
| zip_encrypted | Die ZIP-Datei ist mit Passwort verschlüsselt. |
| zip_unsupported_method | Packverfahren nicht unterstützt. Erlaubt sind ohne Kompression und Deflate (Standard). |
| zip_header_mismatch | Die Angaben im Archiv widersprechen sich. |
| zip_overlap | Dateien überlappen im Archiv. |
| zip_crc_mismatch | Prüfsumme falsch, eine Datei ist beschädigt. |
| zip_symlink | Verknüpfung (Symlink) im Paket. |
| zip_bad_name | Ungültiger Dateiname: Umlaute ohne UTF-8, ../, absolute Pfade, Sonderzeichen, länger als 180 Zeichen oder tiefer als 8 Ordner. |
| zip_duplicate_name | Eine Datei ist doppelt im Archiv. |
| zip_nested_archive | Ein Archiv im Archiv (zum Beispiel ZIP in ZIP). |
Dateien und Inhalt
manifest_missing
manifest.json fehlt. Sie muss oben im ZIP liegen oder im einzigen Ordner darin.
manifest_invalid
manifest.json ist ungültig. Die Fehler stehen darunter (Codes siehe „manifest.json: Referenz“).
entry_missing
Die Startdatei aus entry fehlt im Paket.
file_type_not_allowed
Dieser Dateityp ist nicht erlaubt.
file_content_mismatch
Der Inhalt passt nicht zur Endung (zum Beispiel ein JPG mit der Endung .png).
file_not_utf8
Die Textdatei ist nicht in UTF-8 gespeichert.
file_empty
Die Datei ist leer.
external_reference
Die Datei enthält die Adresse einer anderen Seite (mit Zeile).
forbidden_markup
Nicht erlaubtes HTML (iframe, frame, object, embed, portal, base, meta refresh) oder Skript in einer SVG-Datei.
forbidden_api
Code, der an den Sperren vorbei ins Netz käme: WebRTC (RTCPeerConnection, STUN/TURN), Frames aus JavaScript (createElement("iframe"), "<iframe" in Texten) oder Verbindungs-Hinweise (dns-prefetch, preconnect, prerender, prefetch).
| Code | Bedeutung |
|---|---|
| manifest_missing | manifest.json fehlt. Sie muss oben im ZIP liegen oder im einzigen Ordner darin. |
| manifest_invalid | manifest.json ist ungültig. Die Fehler stehen darunter (Codes siehe „manifest.json: Referenz“). |
| entry_missing | Die Startdatei aus entry fehlt im Paket. |
| file_type_not_allowed | Dieser Dateityp ist nicht erlaubt. |
| file_content_mismatch | Der Inhalt passt nicht zur Endung (zum Beispiel ein JPG mit der Endung .png). |
| file_not_utf8 | Die Textdatei ist nicht in UTF-8 gespeichert. |
| file_empty | Die Datei ist leer. |
| external_reference | Die Datei enthält die Adresse einer anderen Seite (mit Zeile). |
| forbidden_markup | Nicht erlaubtes HTML (iframe, frame, object, embed, portal, base, meta refresh) oder Skript in einer SVG-Datei. |
| forbidden_api | Code, der an den Sperren vorbei ins Netz käme: WebRTC (RTCPeerConnection, STUN/TURN), Frames aus JavaScript (createElement("iframe"), "<iframe" in Texten) oder Verbindungs-Hinweise (dns-prefetch, preconnect, prerender, prefetch). |
Automatischer Test
test_failed heißt: Der automatische Test hat mindestens eine Grenze gerissen. Die einzelnen Gründe stehen darunter, jeweils mit gemessenem Wert und Grenze.
perf_no_ready
Das Widget hat sich nach dem Laden nicht beim Overlay gemeldet. Meist fehlt <script src="/sdk/v1.js"> oder die Seite lädt nie fertig.
perf_ready_slow
Zu langsam bereit: mehr als 3000 ms nach dem Laden der Seite.
perf_unresponsive
Antwortet nicht oder zu langsam auf die Nachfrage des Overlays (der Code blockiert den Browser).
perf_navigated
Das Widget hat die Seite gewechselt oder neu geladen.
perf_flood
Das Widget schickt viel zu viele Nachrichten an das Overlay.
perf_idle_cpu
Mehr als 2 % Rechenleistung, obwohl nichts passiert.
perf_storm_cpu
Mehr als 15 % Rechenleistung bei sehr vielen Ereignissen.
perf_heap
Mehr als 64 MB Arbeitsspeicher.
perf_dom
Mehr als 3000 Elemente auf der Seite.
perf_long_task
Blockiert den Browser länger als 200 ms am Stück.
network_attempt
Versucht, etwas von einer anderen Seite zu laden (der Host steht dabei).
runtime_errors
Nur ein Hinweis, kein Ablehnungsgrund: JavaScript-Fehler während des Tests. Der Admin sieht den ersten Fehler.
| Code | Bedeutung |
|---|---|
| perf_no_ready | Das Widget hat sich nach dem Laden nicht beim Overlay gemeldet. Meist fehlt <script src="/sdk/v1.js"> oder die Seite lädt nie fertig. |
| perf_ready_slow | Zu langsam bereit: mehr als 3000 ms nach dem Laden der Seite. |
| perf_unresponsive | Antwortet nicht oder zu langsam auf die Nachfrage des Overlays (der Code blockiert den Browser). |
| perf_navigated | Das Widget hat die Seite gewechselt oder neu geladen. |
| perf_flood | Das Widget schickt viel zu viele Nachrichten an das Overlay. |
| perf_idle_cpu | Mehr als 2 % Rechenleistung, obwohl nichts passiert. |
| perf_storm_cpu | Mehr als 15 % Rechenleistung bei sehr vielen Ereignissen. |
| perf_heap | Mehr als 64 MB Arbeitsspeicher. |
| perf_dom | Mehr als 3000 Elemente auf der Seite. |
| perf_long_task | Blockiert den Browser länger als 200 ms am Stück. |
| network_attempt | Versucht, etwas von einer anderen Seite zu laden (der Host steht dabei). |
| runtime_errors | Nur ein Hinweis, kein Ablehnungsgrund: JavaScript-Fehler während des Tests. Der Admin sieht den ersten Fehler. |
War dieser Artikel hilfreich?