Widgetregels: groottes, prestatielimieten en controlecodes
Groottes, bestandstypen, prestatielimieten en elke code waarop een controle kan falen.
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
| Limiet | Waarde |
|---|---|
| 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
| Meting | Limiet |
|---|---|
| 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’.,
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).
| Code | Betekenis |
|---|---|
| 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).
| Code | Betekenis |
|---|---|
| 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.
| Code | Betekenis |
|---|---|
| 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?