Regole dei widget: dimensioni, limiti di prestazioni e codici di verifica

Dimensioni, tipi di file, limiti di prestazioni e tutti i codici con cui una verifica può fallire.

8 min di lettura Aggiornato il 4 nov 2026

Un widget gira nell’overlay insieme a tutto il resto, spesso su PC più lenti. Per questo valgono limiti fissi. Livedeck usa gli stessi valori in tre punti: qui nella documentazione, nel test automatico prima dell’approvazione e nell’overlay durante la LIVE.

Il pacchetto

File ZIP

5 MB

Totale decompresso

5 MB

Singolo file

2 MB

File

200

Lunghezza del percorso

180 caratteri

Profondità delle cartelle

8

manifest.json

64 KB

Tipi di file consentiti: html, js, mjs, css, json, svg, txt, md, png, jpg, jpeg, webp, gif, mp3, ogg, wav, woff2. I file di testo devono essere in UTF-8. Immagini, suoni e font devono essere davvero ciò che indica la loro estensione.

Cosa non è consentito

  • Indirizzi di altri siti in HTML, CSS, JavaScript, SVG o JSON (http://, https://, ws://, wss:// o //host). Gli indirizzi nei commenti non fanno fallire la verifica, ma l’admin li vede.
  • iframe, frame, object, embed, portal, base e meta refresh nell’HTML
  • WebRTC (RTCPeerConnection, server STUN o TURN), frame da JavaScript (createElement("iframe") o "<iframe" nelle stringhe) e suggerimenti di connessione come dns-prefetch o preconnect. Livedeck disattiva queste funzioni anche all’interno del widget.
  • Script, gestori di eventi o foreignObject nei file SVG
  • File ZIP criptati, link simbolici e archivi dentro l’archivio

L’admin vede anche segnalazioni su eval, new Function, WebAssembly, WebSocket, accesso alla memoria o alla finestra dell’overlay, schemi di mining e codice offuscato o minificato. Le segnalazioni non fanno fallire subito la verifica, ma serve un buon motivo. Includi il codice minificato insieme ai sorgenti leggibili in una cartella src/.

manifest.json, la cartella src/ e i file .md o .txt servono solo per la revisione. Livedeck non li fornisce mai all’overlay, quindi il tuo codice non può caricarli. Ogni utente riceve il tuo widget a un indirizzo tutto suo.

Limiti di prestazioni

Pronto dopo il caricamento della pagina

3000 ms

Caricamento della pagina durante la LIVE

15.000 ms

CPU senza eventi (media)

2 %

CPU con moltissimi eventi (media)

15 %

Memoria (JavaScript)

64 MB

Elementi nella pagina

3000

Blocco più lungo alla volta

200 ms

Durante la LIVE

  • L’overlay controlla ogni 2000 ms. 3 risposte di fila più lente di 1000 ms, oppure 6000 ms senza alcuna risposta, disattivano il widget.
  • Se era l’overlay stesso a essere bloccato (per esempio perché la scheda era in background), questo non conta mai contro il tuo widget.
  • Un widget disattivato resta spento fino al prossimo ricaricamento. L’editor mostra poi “Widget fermato”.
Consiglio: Mantieni la pagina leggera: rimuovi gli elementi vecchi (lo starter kit mostra al massimo maxCards schede), usa animazioni CSS invece di loop JavaScript e non far girare timer quando non succede nulla.

Codici di verifica

Se una verifica fallisce, l’editor o il seller studio mostrano un elenco di motivi. Qui trovi tutti i codici.

File ZIP

zip_too_large

Il file ZIP supera i 5 MB.

zip_total_too_large

Supera i 5 MB una volta estratto.

zip_file_too_large

Un file supera i 2 MB.

zip_too_many_files

Più di 200 file.

zip_not_zip

Non è un file ZIP, oppure è vuoto.

zip_multi_disk

Diviso in più parti. Metti tutto in un unico file.

zip64_unsupported

ZIP64 non è supportato.

zip_trailing_data

Ci sono dati extra dopo la fine del file ZIP.

zip_corrupt

Il file ZIP è danneggiato.

zip_encrypted

Il file ZIP è protetto da password.

zip_unsupported_method

Metodo di compressione non supportato. Sono ammessi Stored (nessuna compressione) e Deflate (predefinito).

zip_header_mismatch

L’archivio è incoerente.

zip_overlap

Alcuni file si sovrappongono nell’archivio.

zip_crc_mismatch

Checksum errato, un file è danneggiato.

zip_symlink

Link simbolico nel pacchetto.

zip_bad_name

Nome file non valido: caratteri non ASCII senza UTF-8, ../, percorsi assoluti, caratteri speciali, più di 180 caratteri o più di 8 livelli di cartelle.

zip_duplicate_name

Un file compare due volte nell’archivio.

zip_nested_archive

Un archivio dentro l’archivio (ad esempio uno ZIP nello ZIP).

File e contenuto

manifest_missing

Manca manifest.json. Deve trovarsi nella radice dello ZIP o nella sua unica cartella.

manifest_invalid

manifest.json non è valido. Gli errori sono elencati sotto (codici in “Riferimento manifest.json”).

entry_missing

Il file iniziale indicato in entry non è nel pacchetto.

file_type_not_allowed

Questo tipo di file non è consentito.

file_content_mismatch

Il contenuto non corrisponde all’estensione (ad esempio un JPG chiamato .png).

file_not_utf8

Il file di testo non è salvato in UTF-8.

file_empty

Il file è vuoto.

external_reference

Il file contiene l’indirizzo di un altro sito (con la riga).

forbidden_markup

HTML non consentito (iframe, frame, object, embed, portal, base, meta refresh) o script in un file SVG.

forbidden_api

Codice che aggirerebbe i blocchi di rete: WebRTC (RTCPeerConnection, STUN/TURN), frame da JavaScript (createElement("iframe"), "<iframe" nelle stringhe) o suggerimenti di connessione (dns-prefetch, preconnect, prerender, prefetch).

Test automatico

test_failed significa che il test automatico ha superato almeno un limite. I singoli motivi sono elencati sotto, ognuno con il valore misurato e il limite.

perf_no_ready

Dopo il caricamento il widget non si è mai comunicato all’overlay. Di solito manca <script src="/sdk/v1.js"> o la pagina non finisce mai di caricarsi.

perf_ready_slow

Pronto troppo tardi: oltre 3000 ms dopo il caricamento della pagina.

perf_unresponsive

Non risponde al controllo dell’overlay, o risponde troppo lentamente (il codice blocca il browser).

perf_navigated

Il widget ha cambiato pagina o l’ha ricaricata.

perf_flood

Il widget invia troppi messaggi all’overlay.

perf_idle_cpu

Più del 2 % di CPU quando non succede nulla.

perf_storm_cpu

Più del 15 % di CPU con molti eventi.

perf_heap

Più di 64 MB di memoria.

perf_dom

Più di 3000 elementi nella pagina.

perf_long_task

Blocca il browser per più di 200 ms di fila.

network_attempt

Prova a caricare qualcosa da un altro sito (viene mostrato l’host).

runtime_errors

Solo un avviso, non un motivo di rifiuto: errori JavaScript durante il test. L’admin vede il primo.

Questo articolo ti è stato utile?