Règles des widgets : tailles, limites de performance et codes de vérification
Tailles, types de fichiers, limites de performance et tous les codes d’échec possibles d’une vérification.
Un widget tourne dans l’overlay à côté de tout le reste, souvent sur des PC peu puissants. C’est pourquoi des limites fixes s’appliquent. Livedeck utilise les mêmes valeurs à trois endroits : ici dans la documentation, dans le test automatique avant validation et dans l’overlay pendant le LIVE.
Le package
Fichier ZIP
5 Mo
Total décompressé
5 Mo
Fichier individuel
2 Mo
Fichiers
200
Longueur du chemin
180 caractères
Profondeur des dossiers
8
manifest.json
64 Ko
| Limite | Valeur |
|---|---|
| Fichier ZIP | 5 Mo |
| Total décompressé | 5 Mo |
| Fichier individuel | 2 Mo |
| Fichiers | 200 |
| Longueur du chemin | 180 caractères |
| Profondeur des dossiers | 8 |
| manifest.json | 64 Ko |
Types de fichiers autorisés : html, js, mjs, css, json, svg, txt, md, png, jpg, jpeg, webp, gif, mp3, ogg, wav, woff2. Les fichiers texte doivent être en UTF-8. Les images, sons et polices doivent réellement correspondre à leur extension.
Ce qui est interdit
- Les adresses d’autres sites en HTML, CSS, JavaScript, SVG ou JSON (http://, https://, ws://, wss:// ou //host). Les adresses dans les commentaires ne font pas échouer la vérification, mais l’admin les voit.
- iframe, frame, object, embed, portal, base et meta refresh en HTML
- WebRTC (RTCPeerConnection, serveurs STUN ou TURN), les frames depuis JavaScript (createElement("iframe") ou "<iframe" dans des chaînes) et les indications de connexion comme dns-prefetch ou preconnect. Livedeck désactive aussi ces fonctionnalités dans le widget.
- Scripts, gestionnaires d’événements ou foreignObject dans les fichiers SVG
- Fichiers ZIP chiffrés, liens symboliques et archives dans l’archive
L’admin voit aussi des signalements concernant eval, new Function, WebAssembly, les WebSockets, l’accès au stockage ou à la fenêtre de l’overlay, les schémas de minage et le code obfusqué ou minifié. Ces signalements ne font pas échouer la vérification immédiatement, mais ils doivent être justifiés. Fournissez le code minifié avec ses sources lisibles dans un dossier src/.
manifest.json, le dossier src/ et les fichiers .md ou .txt servent uniquement à la vérification. Livedeck ne les transmet jamais à l’overlay : votre code ne peut donc pas les charger. Chaque utilisateur reçoit votre widget sous sa propre adresse.
Limites de performance
Prêt après le chargement de la page
3000 ms
Chargement de la page pendant le LIVE
15,000 ms
CPU sans événements (moyenne)
2 %
CPU avec de très nombreux événements (moyenne)
15 %
Mémoire (JavaScript)
64 Mo
Éléments sur la page
3000
Blocage le plus long d’affilée
200 ms
| Mesure | Limite |
|---|---|
| Prêt après le chargement de la page | 3000 ms |
| Chargement de la page pendant le LIVE | 15,000 ms |
| CPU sans événements (moyenne) | 2 % |
| CPU avec de très nombreux événements (moyenne) | 15 % |
| Mémoire (JavaScript) | 64 Mo |
| Éléments sur la page | 3000 |
| Blocage le plus long d’affilée | 200 ms |
Pendant le LIVE
- L’overlay vérifie toutes les 2000 ms. 3 réponses d’affilée de plus de 1000 ms, ou 6000 ms sans aucune réponse, désactivent le widget.
- Si l’overlay lui-même était bloqué (par exemple parce que l’onglet était en arrière-plan), cela n’est jamais compté contre votre widget.
- Un widget désactivé le reste jusqu’au prochain rechargement. L’éditeur affiche alors « Widget arrêté ».
Codes de vérification
Quand une vérification échoue, l’éditeur ou le studio vendeur affiche la liste des raisons. Tous les codes sont listés ici.
Fichier ZIP
zip_too_large
Le fichier ZIP dépasse 5 Mo.
zip_total_too_large
Dépasse 5 Mo une fois décompressé.
zip_file_too_large
Un fichier dépasse 2 Mo.
zip_too_many_files
Plus de 200 fichiers.
zip_not_zip
Ce n’est pas un fichier ZIP, ou il est vide.
zip_multi_disk
Divisé en plusieurs parties. Regroupez tout dans un seul fichier.
zip64_unsupported
ZIP64 n’est pas pris en charge.
zip_trailing_data
Il y a des données supplémentaires après la fin du fichier ZIP.
zip_corrupt
Le fichier ZIP est endommagé.
zip_encrypted
Le fichier ZIP est protégé par un mot de passe.
zip_unsupported_method
Méthode de compression non prise en charge. Stored (sans compression) et Deflate (par défaut) sont autorisés.
zip_header_mismatch
L’archive est incohérente.
zip_overlap
Des fichiers se chevauchent dans l’archive.
zip_crc_mismatch
Somme de contrôle incorrecte, un fichier est endommagé.
zip_symlink
Lien symbolique dans le package.
zip_bad_name
Nom de fichier invalide : non-ASCII sans UTF-8, ../, chemins absolus, caractères spéciaux, plus de 180 caractères ou plus de 8 niveaux de dossiers.
zip_duplicate_name
Un fichier apparaît deux fois dans l’archive.
zip_nested_archive
Une archive dans l’archive (par exemple un ZIP dans le ZIP).
| Code | Signification |
|---|---|
| zip_too_large | Le fichier ZIP dépasse 5 Mo. |
| zip_total_too_large | Dépasse 5 Mo une fois décompressé. |
| zip_file_too_large | Un fichier dépasse 2 Mo. |
| zip_too_many_files | Plus de 200 fichiers. |
| zip_not_zip | Ce n’est pas un fichier ZIP, ou il est vide. |
| zip_multi_disk | Divisé en plusieurs parties. Regroupez tout dans un seul fichier. |
| zip64_unsupported | ZIP64 n’est pas pris en charge. |
| zip_trailing_data | Il y a des données supplémentaires après la fin du fichier ZIP. |
| zip_corrupt | Le fichier ZIP est endommagé. |
| zip_encrypted | Le fichier ZIP est protégé par un mot de passe. |
| zip_unsupported_method | Méthode de compression non prise en charge. Stored (sans compression) et Deflate (par défaut) sont autorisés. |
| zip_header_mismatch | L’archive est incohérente. |
| zip_overlap | Des fichiers se chevauchent dans l’archive. |
| zip_crc_mismatch | Somme de contrôle incorrecte, un fichier est endommagé. |
| zip_symlink | Lien symbolique dans le package. |
| zip_bad_name | Nom de fichier invalide : non-ASCII sans UTF-8, ../, chemins absolus, caractères spéciaux, plus de 180 caractères ou plus de 8 niveaux de dossiers. |
| zip_duplicate_name | Un fichier apparaît deux fois dans l’archive. |
| zip_nested_archive | Une archive dans l’archive (par exemple un ZIP dans le ZIP). |
Fichiers et contenu
manifest_missing
manifest.json est manquant. Il doit se trouver à la racine du ZIP ou dans son unique dossier.
manifest_invalid
manifest.json est invalide. Les erreurs sont listées en dessous (codes dans « Référence manifest.json »).
entry_missing
Le fichier de démarrage indiqué dans entry ne figure pas dans le package.
file_type_not_allowed
Ce type de fichier n’est pas autorisé.
file_content_mismatch
Le contenu ne correspond pas à l’extension (par exemple un JPG nommé .png).
file_not_utf8
Le fichier texte n’est pas enregistré en UTF-8.
file_empty
Le fichier est vide.
external_reference
Le fichier contient l’adresse d’un autre site (avec la ligne).
forbidden_markup
HTML non autorisé (iframe, frame, object, embed, portal, base, meta refresh) ou script dans un fichier SVG.
forbidden_api
Code qui contournerait les blocages réseau : WebRTC (RTCPeerConnection, STUN/TURN), frames créées en JavaScript (createElement("iframe"), "<iframe" dans des chaînes) ou indications de connexion (dns-prefetch, preconnect, prerender, prefetch).
| Code | Signification |
|---|---|
| manifest_missing | manifest.json est manquant. Il doit se trouver à la racine du ZIP ou dans son unique dossier. |
| manifest_invalid | manifest.json est invalide. Les erreurs sont listées en dessous (codes dans « Référence manifest.json »). |
| entry_missing | Le fichier de démarrage indiqué dans entry ne figure pas dans le package. |
| file_type_not_allowed | Ce type de fichier n’est pas autorisé. |
| file_content_mismatch | Le contenu ne correspond pas à l’extension (par exemple un JPG nommé .png). |
| file_not_utf8 | Le fichier texte n’est pas enregistré en UTF-8. |
| file_empty | Le fichier est vide. |
| external_reference | Le fichier contient l’adresse d’un autre site (avec la ligne). |
| forbidden_markup | HTML non autorisé (iframe, frame, object, embed, portal, base, meta refresh) ou script dans un fichier SVG. |
| forbidden_api | Code qui contournerait les blocages réseau : WebRTC (RTCPeerConnection, STUN/TURN), frames créées en JavaScript (createElement("iframe"), "<iframe" dans des chaînes) ou indications de connexion (dns-prefetch, preconnect, prerender, prefetch). |
Test automatique
test_failed signifie que le test automatique a dépassé au moins une limite. Les raisons sont listées en dessous, chacune avec la valeur mesurée et la limite.
perf_no_ready
Le widget ne s’est jamais signalé à l’overlay après le chargement. En général, <script src="/sdk/v1.js"> manque ou la page ne finit jamais de charger.
perf_ready_slow
Prêt trop tard : plus de 3000 ms après le chargement de la page.
perf_unresponsive
Ne répond pas à la vérification de l’overlay, ou trop lentement (le code bloque le navigateur).
perf_navigated
Le widget a quitté sa page ou l’a rechargée.
perf_flood
Le widget envoie beaucoup trop de messages à l’overlay.
perf_idle_cpu
Plus de 2 % de CPU quand il ne se passe rien.
perf_storm_cpu
Plus de 15 % de CPU avec beaucoup d’événements.
perf_heap
Plus de 64 Mo de mémoire.
perf_dom
Plus de 3000 éléments sur la page.
perf_long_task
Bloque le navigateur plus de 200 ms d’affilée.
network_attempt
Tente de charger quelque chose depuis un autre site (l’hôte est affiché).
runtime_errors
Simple indication, pas un motif d’échec : erreurs JavaScript pendant le test. L’admin voit la première.
| Code | Signification |
|---|---|
| perf_no_ready | Le widget ne s’est jamais signalé à l’overlay après le chargement. En général, <script src="/sdk/v1.js"> manque ou la page ne finit jamais de charger. |
| perf_ready_slow | Prêt trop tard : plus de 3000 ms après le chargement de la page. |
| perf_unresponsive | Ne répond pas à la vérification de l’overlay, ou trop lentement (le code bloque le navigateur). |
| perf_navigated | Le widget a quitté sa page ou l’a rechargée. |
| perf_flood | Le widget envoie beaucoup trop de messages à l’overlay. |
| perf_idle_cpu | Plus de 2 % de CPU quand il ne se passe rien. |
| perf_storm_cpu | Plus de 15 % de CPU avec beaucoup d’événements. |
| perf_heap | Plus de 64 Mo de mémoire. |
| perf_dom | Plus de 3000 éléments sur la page. |
| perf_long_task | Bloque le navigateur plus de 200 ms d’affilée. |
| network_attempt | Tente de charger quelque chose depuis un autre site (l’hôte est affiché). |
| runtime_errors | Simple indication, pas un motif d’échec : erreurs JavaScript pendant le test. L’admin voit la première. |
Cet article vous a-t-il été utile ?