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.

8 min de lectura Actualizado el 4 nov 2026

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

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

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”.
Consejo: Mantén la página ligera: elimina los elementos antiguos (el starter kit muestra como máximo maxCards tarjetas), usa animaciones CSS en lugar de bucles de JavaScript y no ejecutes temporizadores mientras no pasa nada.

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

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

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.

¿Te resultó útil este artículo?