Reglas de widgets: tamaños, límites de rendimiento y códigos de revisión
Tamaños, tipos de archivo, límites de rendimiento y todos los códigos por los que puede fallar una revisión.
Un widget se ejecuta en el overlay junto a todo lo demás, a menudo en PCs lentos. Por eso hay límites fijos. Livedeck usa los mismos valores en tres sitios: aquí en la documentación, en la prueba automática antes de la aprobación y en el overlay durante el LIVE.
El paquete
Archivo ZIP
5 MB
Total descomprimido
5 MB
Archivo individual
2 MB
Archivos
200
Longitud de ruta
180 caracteres
Profundidad de carpetas
8
manifest.json
64 KB
| Límite | Valor |
|---|---|
| Archivo ZIP | 5 MB |
| Total descomprimido | 5 MB |
| Archivo individual | 2 MB |
| Archivos | 200 |
| Longitud de ruta | 180 caracteres |
| Profundidad de carpetas | 8 |
| manifest.json | 64 KB |
Tipos de archivo permitidos: html, js, mjs, css, json, svg, txt, md, png, jpg, jpeg, webp, gif, mp3, ogg, wav, woff2. Los archivos de texto deben estar en UTF-8. Las imágenes, sonidos y fuentes deben ser realmente lo que indica su extensión.
Qué no está permitido
- Direcciones de otros sitios en HTML, CSS, JavaScript, SVG o JSON (http://, https://, ws://, wss:// o //host). Las direcciones en comentarios no hacen fallar la revisión, pero el admin las ve.
- iframe, frame, object, embed, portal, base y meta refresh en HTML
- WebRTC (RTCPeerConnection, servidores STUN o TURN), frames desde JavaScript (createElement("iframe") o "<iframe" en strings) y pistas de conexión como dns-prefetch o preconnect. Livedeck también desactiva estas funciones dentro del widget.
- Scripts, event handlers o foreignObject en archivos SVG
- Archivos ZIP cifrados, enlaces simbólicos y archivos comprimidos dentro del archivo
El admin también ve avisos sobre eval, new Function, WebAssembly, WebSockets, acceso al almacenamiento o a la ventana del overlay, patrones de minería y código ofuscado o minificado. Los avisos no hacen fallar la revisión de inmediato, pero necesitan una buena razón. Entrega el código minificado junto con el código fuente legible en una carpeta src/.
manifest.json, la carpeta src/ y los archivos .md o .txt son solo para la revisión. Livedeck nunca los entrega al overlay, así que tu código no puede cargarlos. Cada usuario recibe tu widget en una dirección propia.
Límites de rendimiento
Listo tras cargar la página
3000 ms
Carga de la página durante el LIVE
15,000 ms
CPU sin eventos (promedio)
2 %
CPU con muchísimos eventos (promedio)
15 %
Memoria (JavaScript)
64 MB
Elementos en la página
3000
Bloqueo más largo seguido
200 ms
| Medición | Límite |
|---|---|
| Listo tras cargar la página | 3000 ms |
| Carga de la página durante el LIVE | 15,000 ms |
| CPU sin eventos (promedio) | 2 % |
| CPU con muchísimos eventos (promedio) | 15 % |
| Memoria (JavaScript) | 64 MB |
| Elementos en la página | 3000 |
| Bloqueo más largo seguido | 200 ms |
Durante el LIVE
- El overlay comprueba cada 2000 ms. 3 respuestas seguidas más lentas de 1000 ms, o 6000 ms sin ninguna respuesta, desactivan el widget.
- Si el propio overlay estaba bloqueado (por ejemplo, porque la pestaña estaba en segundo plano), eso nunca cuenta en contra de tu widget.
- Un widget que se desactivó sigue desactivado hasta la próxima recarga. El editor muestra entonces “Widget detenido”.
Códigos de revisión
Si una revisión falla, el editor o el estudio de vendedor muestra una lista de motivos. Aquí tienes todos los códigos.
Archivo ZIP
zip_too_large
El archivo ZIP pesa más de 5 MB.
zip_total_too_large
Pesa más de 5 MB una vez descomprimido.
zip_file_too_large
Un archivo pesa más de 2 MB.
zip_too_many_files
Más de 200 archivos.
zip_not_zip
No es un archivo ZIP o está vacío.
zip_multi_disk
Dividido en varias partes. Empaqueta todo en un solo archivo.
zip64_unsupported
ZIP64 no es compatible.
zip_trailing_data
Hay datos extra después del final del archivo ZIP.
zip_corrupt
El archivo ZIP está dañado.
zip_encrypted
El archivo ZIP está protegido con contraseña.
zip_unsupported_method
Método de compresión no compatible. Se permiten Stored (sin compresión) y Deflate (el predeterminado).
zip_header_mismatch
El archivo comprimido se contradice.
zip_overlap
Hay archivos que se solapan dentro del archivo comprimido.
zip_crc_mismatch
Suma de verificación incorrecta: un archivo está dañado.
zip_symlink
Enlace simbólico en el paquete.
zip_bad_name
Nombre de archivo no válido: caracteres no ASCII sin UTF-8, ../, rutas absolutas, caracteres especiales, más de 180 caracteres o más de 8 niveles de carpetas.
zip_duplicate_name
Un archivo aparece dos veces en el archivo comprimido.
zip_nested_archive
Un archivo comprimido dentro de otro (por ejemplo, un ZIP dentro del ZIP).
| Código | Significado |
|---|---|
| zip_too_large | El archivo ZIP pesa más de 5 MB. |
| zip_total_too_large | Pesa más de 5 MB una vez descomprimido. |
| zip_file_too_large | Un archivo pesa más de 2 MB. |
| zip_too_many_files | Más de 200 archivos. |
| zip_not_zip | No es un archivo ZIP o está vacío. |
| zip_multi_disk | Dividido en varias partes. Empaqueta todo en un solo archivo. |
| zip64_unsupported | ZIP64 no es compatible. |
| zip_trailing_data | Hay datos extra después del final del archivo ZIP. |
| zip_corrupt | El archivo ZIP está dañado. |
| zip_encrypted | El archivo ZIP está protegido con contraseña. |
| zip_unsupported_method | Método de compresión no compatible. Se permiten Stored (sin compresión) y Deflate (el predeterminado). |
| zip_header_mismatch | El archivo comprimido se contradice. |
| zip_overlap | Hay archivos que se solapan dentro del archivo comprimido. |
| zip_crc_mismatch | Suma de verificación incorrecta: un archivo está dañado. |
| zip_symlink | Enlace simbólico en el paquete. |
| zip_bad_name | Nombre de archivo no válido: caracteres no ASCII sin UTF-8, ../, rutas absolutas, caracteres especiales, más de 180 caracteres o más de 8 niveles de carpetas. |
| zip_duplicate_name | Un archivo aparece dos veces en el archivo comprimido. |
| zip_nested_archive | Un archivo comprimido dentro de otro (por ejemplo, un ZIP dentro del ZIP). |
Archivos y contenido
manifest_missing
Falta manifest.json. Debe estar en la raíz del ZIP o dentro de su única carpeta.
manifest_invalid
manifest.json no es válido. Los errores aparecen debajo (códigos en “Referencia de manifest.json”).
entry_missing
El archivo de inicio indicado en entry no está en el paquete.
file_type_not_allowed
Este tipo de archivo no está permitido.
file_content_mismatch
El contenido no coincide con la extensión (por ejemplo, un JPG llamado .png).
file_not_utf8
El archivo de texto no está guardado en UTF-8.
file_empty
El archivo está vacío.
external_reference
El archivo contiene la dirección de otro sitio (con la línea).
forbidden_markup
HTML no permitido (iframe, frame, object, embed, portal, base, meta refresh) o script en un archivo SVG.
forbidden_api
Código que intentaría saltarse los bloqueos de red: WebRTC (RTCPeerConnection, STUN/TURN), frames desde JavaScript (createElement("iframe"), "<iframe" en strings) o indicaciones de conexión (dns-prefetch, preconnect, prerender, prefetch).
| Código | Significado |
|---|---|
| manifest_missing | Falta manifest.json. Debe estar en la raíz del ZIP o dentro de su única carpeta. |
| manifest_invalid | manifest.json no es válido. Los errores aparecen debajo (códigos en “Referencia de manifest.json”). |
| entry_missing | El archivo de inicio indicado en entry no está en el paquete. |
| file_type_not_allowed | Este tipo de archivo no está permitido. |
| file_content_mismatch | El contenido no coincide con la extensión (por ejemplo, un JPG llamado .png). |
| file_not_utf8 | El archivo de texto no está guardado en UTF-8. |
| file_empty | El archivo está vacío. |
| external_reference | El archivo contiene la dirección de otro sitio (con la línea). |
| forbidden_markup | HTML no permitido (iframe, frame, object, embed, portal, base, meta refresh) o script en un archivo SVG. |
| forbidden_api | Código que intentaría saltarse los bloqueos de red: WebRTC (RTCPeerConnection, STUN/TURN), frames desde JavaScript (createElement("iframe"), "<iframe" en strings) o indicaciones de conexión (dns-prefetch, preconnect, prerender, prefetch). |
Prueba automática
test_failed significa que la prueba automática superó al menos un límite. Los motivos concretos aparecen debajo, cada uno con el valor medido y el límite.
perf_no_ready
El widget nunca se comunicó con el overlay después de cargar. Normalmente falta <script src="/sdk/v1.js"> o la página nunca termina de cargar.
perf_ready_slow
Listo demasiado tarde: más de 3000 ms después de cargar la página.
perf_unresponsive
No responde a la comprobación del overlay o lo hace muy lento (el código bloquea el navegador).
perf_navigated
El widget salió de su página o la recargó.
perf_flood
El widget envía demasiados mensajes al overlay.
perf_idle_cpu
Más del 2 % de CPU mientras no pasa nada.
perf_storm_cpu
Más del 15 % de CPU con muchos eventos.
perf_heap
Más de 64 MB de memoria.
perf_dom
Más de 3000 elementos en la página.
perf_long_task
Bloquea el navegador más de 200 ms seguidos.
network_attempt
Intenta cargar algo de otro sitio (se muestra el host).
runtime_errors
Solo un aviso, no un motivo de rechazo: errores de JavaScript durante la prueba. El admin ve el primero.
| Código | Significado |
|---|---|
| perf_no_ready | El widget nunca se comunicó con el overlay después de cargar. Normalmente falta <script src="/sdk/v1.js"> o la página nunca termina de cargar. |
| perf_ready_slow | Listo demasiado tarde: más de 3000 ms después de cargar la página. |
| perf_unresponsive | No responde a la comprobación del overlay o lo hace muy lento (el código bloquea el navegador). |
| perf_navigated | El widget salió de su página o la recargó. |
| perf_flood | El widget envía demasiados mensajes al overlay. |
| perf_idle_cpu | Más del 2 % de CPU mientras no pasa nada. |
| perf_storm_cpu | Más del 15 % de CPU con muchos eventos. |
| perf_heap | Más de 64 MB de memoria. |
| perf_dom | Más de 3000 elementos en la página. |
| perf_long_task | Bloquea el navegador más de 200 ms seguidos. |
| network_attempt | Intenta cargar algo de otro sitio (se muestra el host). |
| runtime_errors | Solo un aviso, no un motivo de rechazo: errores de JavaScript durante la prueba. El admin ve el primero. |
¿Te resultó útil este artículo?