Widgetregels: groottes, prestatielimieten en controlecodes

Groottes, bestandstypen, prestatielimieten en elke code waarop een controle kan falen.

8 min. lezen Bijgewerkt op 4 nov 2026

Een widget draait in de overlay naast al het andere, vaak op tragere pc’s. Daarom gelden vaste limieten. Livedeck gebruikt dezelfde getallen op drie plekken: hier in de docs, in de automatische test vóór goedkeuring en in de overlay tijdens de LIVE.

Het pakket

ZIP-bestand

5 MB

Uitgepakt in totaal

5 MB

Los bestand

2 MB

Bestanden

200

Padlengte

180 tekens

Mapdiepte

8

manifest.json

64 KB

Toegestane bestandstypen: html, js, mjs, css, json, svg, txt, md, png, jpg, jpeg, webp, gif, mp3, ogg, wav, woff2. Tekstbestanden moeten UTF-8 zijn. Afbeeldingen, geluiden en lettertypen moeten echt zijn wat hun extensie zegt.

Wat niet mag

  • Adressen van andere sites in HTML, CSS, JavaScript, SVG of JSON (http://, https://, ws://, wss:// of //host). Adressen in commentaar laten de controle niet falen, maar de admin ziet ze wel.
  • iframe, frame, object, embed, portal, base en meta refresh in HTML
  • WebRTC (RTCPeerConnection, STUN- of TURN-servers), frames vanuit JavaScript (createElement("iframe") of "<iframe" in strings) en verbindingshints zoals dns-prefetch of preconnect. Livedeck schakelt deze functies in de widget ook uit.
  • Scripts, event handlers of foreignObject in SVG-bestanden
  • Versleutelde ZIP-bestanden, symbolische links en archieven binnen het archief

De admin ziet ook hints over eval, new Function, WebAssembly, WebSockets, toegang tot opslag of het overlayvenster, miningpatronen en versluierde of geminificeerde code. Hints laten de controle niet meteen falen, maar er moet een goede reden voor zijn. Lever geminificeerde code mee met leesbare broncode in een map src/.

manifest.json, de map src/ en .md- of .txt-bestanden zijn alleen voor de review. Livedeck levert ze nooit aan de overlay, dus je code kan ze niet laden. Elke gebruiker krijgt je widget onder een eigen adres.

Prestatielimieten

Klaar nadat de pagina is geladen

3000 ms

Pagina laden tijdens de LIVE

15.000 ms

CPU zonder events (gemiddeld)

2 %

CPU bij heel veel events (gemiddeld)

15 %

Geheugen (JavaScript)

64 MB

Elementen op de pagina

3000

Langste blokkade in één keer

200 ms

Tijdens de LIVE

  • De overlay controleert elke 2000 ms. Bij 3 antwoorden op rij trager dan 1000 ms, of 6000 ms zonder antwoord, wordt de widget uitgeschakeld.
  • Als de overlay zelf vastzat (bijvoorbeeld omdat het tabblad op de achtergrond stond), telt dat nooit tegen je widget.
  • Een widget die is uitgeschakeld, blijft uit tot de volgende herlaadbeurt. De editor toont dan ‘Widget gestopt’.,
Tip: Houd de pagina klein: verwijder oude elementen (de starterkit toont maximaal maxCards kaarten), gebruik CSS-animaties in plaats van JavaScript-loops en laat geen timers lopen als er niets gebeurt.

Controlecodes

Als een controle mislukt, toont de editor of de verkopersstudio een lijst met redenen. Hier vind je elke code.

ZIP-bestand

zip_too_large

Het ZIP-bestand is groter dan 5 MB.

zip_total_too_large

Uitgepakt groter dan 5 MB.

zip_file_too_large

Een bestand is groter dan 2 MB.

zip_too_many_files

Meer dan 200 bestanden.

zip_not_zip

Geen ZIP-bestand, of een leeg bestand.

zip_multi_disk

Opgesplitst in meerdere delen. Pak alles in één bestand in.

zip64_unsupported

ZIP64 wordt niet ondersteund.

zip_trailing_data

Er staan extra gegevens na het einde van het ZIP-bestand.

zip_corrupt

Het ZIP-bestand is beschadigd.

zip_encrypted

Het ZIP-bestand is beveiligd met een wachtwoord.

zip_unsupported_method

Compressiemethode niet ondersteund. Stored (geen compressie) en Deflate (standaard) zijn toegestaan.

zip_header_mismatch

Het archief spreekt zichzelf tegen.

zip_overlap

Bestanden overlappen elkaar in het archief.

zip_crc_mismatch

Checksum klopt niet, een bestand is beschadigd.

zip_symlink

Symbolische link in het pakket.

zip_bad_name

Ongeldige bestandsnaam: niet-ASCII zonder UTF-8, ../, absolute paden, speciale tekens, langer dan 180 tekens of dieper dan 8 mappen.

zip_duplicate_name

Een bestand staat twee keer in het archief.

zip_nested_archive

Een archief in het archief (bijvoorbeeld een ZIP in de ZIP).

Bestanden en inhoud

manifest_missing

manifest.json ontbreekt. Het moet bovenaan in de ZIP staan of in de enige map ervan.

manifest_invalid

manifest.json is ongeldig. De fouten staan eronder (codes in ‘manifest.json-referentie’).

entry_missing

Het startbestand dat in entry staat, zit niet in het pakket.

file_type_not_allowed

Dit bestandstype is niet toegestaan.

file_content_mismatch

De inhoud past niet bij de extensie (bijvoorbeeld een JPG met de naam .png).

file_not_utf8

Het tekstbestand is niet als UTF-8 opgeslagen.

file_empty

Het bestand is leeg.

external_reference

Het bestand bevat het adres van een andere site (met de regel).

forbidden_markup

Niet-toegestane HTML (iframe, frame, object, embed, portal, base, meta refresh) of script in een SVG-bestand.

forbidden_api

Code die de netwerkblokkades zou omzeilen: WebRTC (RTCPeerConnection, STUN/TURN), frames vanuit JavaScript (createElement("iframe"), "<iframe" in strings) of verbindingshints (dns-prefetch, preconnect, prerender, prefetch).

Automatische test

test_failed betekent dat de automatische test minstens één limiet heeft overschreden. De afzonderlijke redenen staan eronder, elk met de gemeten waarde en de limiet.

perf_no_ready

De widget heeft zich na het laden nooit bij de overlay gemeld. Meestal ontbreekt <script src="/sdk/v1.js"> of wordt de pagina nooit klaar met laden.

perf_ready_slow

Te laat klaar: meer dan 3000 ms nadat de pagina is geladen.

perf_unresponsive

Reageert niet of te traag op de controle van de overlay (de code blokkeert de browser).

perf_navigated

De widget is naar een andere pagina gegaan of heeft zijn pagina herladen.

perf_flood

De widget stuurt veel te veel berichten naar de overlay.

perf_idle_cpu

Meer dan 2 % CPU terwijl er niets gebeurt.

perf_storm_cpu

Meer dan 15 % CPU bij veel events.

perf_heap

Meer dan 64 MB geheugen.

perf_dom

Meer dan 3000 elementen op de pagina.

perf_long_task

Blokkeert de browser langer dan 200 ms achter elkaar.

network_attempt

Probeert iets van een andere site te laden (de host wordt getoond).

runtime_errors

Alleen een hint, geen reden om af te keuren: JavaScript-fouten tijdens de test. De admin ziet de eerste.

Was dit artikel nuttig?