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.
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
| Limite | Valore |
|---|---|
| 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
| Misurazione | Limite |
|---|---|
| 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”.
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).
| Codice | Significato |
|---|---|
| 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).
| Codice | Significato |
|---|---|
| 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.
| Codice | Significato |
|---|---|
| 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?