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.

8 min de lecture Mis à jour le 4 nov. 2026

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

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

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é ».
Astuce : Gardez une page légère : supprimez les anciens éléments (le kit de démarrage affiche au maximum maxCards cartes), utilisez des animations CSS plutôt que des boucles JavaScript et ne faites pas tourner de minuteurs quand il ne se passe rien.

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).

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).

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.

Cet article vous a-t-il été utile ?