Widget-Regeln: Größen, Leistungsgrenzen und Prüfcodes

Größen, Dateitypen, Leistungsgrenzen und jeder Code, mit dem eine Prüfung scheitern kann.

8 Min. Lesezeit Aktualisiert 4. Nov. 2026

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

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

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“.
Tipp: Halte die Seite klein: Entferne alte Elemente (das Starter-Kit zeigt höchstens maxCards Karten), nutze CSS-Animationen statt JavaScript-Schleifen und lass keine Timer laufen, wenn nichts passiert.

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).

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).

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.

War dieser Artikel hilfreich?