Regras de widgets: tamanhos, limites de desempenho e códigos de verificação

Tamanhos, tipos de arquivo, limites de desempenho e todos os códigos de falha da verificação.

8 min de leitura Atualizado em 4 de nov. de 2026

Um widget roda no overlay junto com todo o resto, muitas vezes em PCs mais fracos. Por isso existem limites fixos. O Livedeck usa os mesmos números em três lugares: aqui na documentação, no teste automático antes da aprovação e no overlay durante a LIVE.

O pacote

Arquivo ZIP

5 MB

Total descompactado

5 MB

Arquivo individual

2 MB

Arquivos

200

Tamanho do caminho

180 caracteres

Profundidade de pastas

8

manifest.json

64 KB

Tipos de arquivo permitidos: html, js, mjs, css, json, svg, txt, md, png, jpg, jpeg, webp, gif, mp3, ogg, wav, woff2. Arquivos de texto precisam estar em UTF-8. Imagens, sons e fontes precisam ser de fato o que a extensão indica.

O que não é permitido

  • Endereços de outros sites em HTML, CSS, JavaScript, SVG ou JSON (http://, https://, ws://, wss:// ou //host). Endereços em comentários não reprovam a verificação, mas o admin vê.
  • iframe, frame, object, embed, portal, base e meta refresh no HTML
  • WebRTC (RTCPeerConnection, servidores STUN ou TURN), frames via JavaScript (createElement("iframe") ou "<iframe" em strings) e dicas de conexão como dns-prefetch ou preconnect. O Livedeck também desativa esses recursos dentro do widget.
  • Scripts, event handlers ou foreignObject em arquivos SVG
  • Arquivos ZIP criptografados, links simbólicos e arquivos compactados dentro do arquivo

O admin também vê alertas sobre eval, new Function, WebAssembly, WebSockets, acesso ao armazenamento ou à janela do overlay, padrões de mineração e código ofuscado ou minificado. Os alertas não reprovam a verificação na hora, mas precisam de um bom motivo. Envie código minificado junto com o código-fonte legível em uma pasta src/.

manifest.json, a pasta src/ e arquivos .md ou .txt são só para a análise. O Livedeck nunca os entrega ao overlay, então seu código não consegue carregá-los. Cada usuário recebe seu widget em um endereço próprio.

Limites de desempenho

Pronto após o carregamento da página

3000 ms

Carregamento da página durante a LIVE

15.000 ms

CPU sem eventos (média)

2 %

CPU com muitos eventos (média)

15 %

Memória (JavaScript)

64 MB

Elementos na página

3000

Maior bloqueio contínuo

200 ms

Durante a LIVE

  • O overlay verifica a cada 2000 ms. 3 respostas seguidas acima de 1000 ms, ou 6000 ms sem resposta, desativam o widget.
  • Quando o próprio overlay travou (por exemplo, porque a aba estava em segundo plano), isso nunca conta contra o seu widget.
  • Um widget que foi desligado continua desligado até a próxima recarga. O editor então mostra "Widget parado".
Dica: Mantenha a página leve: remova elementos antigos (o starter kit mostra no máximo maxCards cards), use animações CSS em vez de loops em JavaScript e não rode timers enquanto nada acontece.

Códigos de verificação

Quando uma verificação falha, o editor ou o seller studio mostra uma lista de motivos. Todos os códigos estão listados aqui.

Arquivo ZIP

zip_too_large

O arquivo ZIP tem mais de 5 MB.

zip_total_too_large

Mais de 5 MB depois de descompactado.

zip_file_too_large

Um arquivo tem mais de 2 MB.

zip_too_many_files

Mais de 200 arquivos.

zip_not_zip

Não é um arquivo ZIP ou está vazio.

zip_multi_disk

Dividido em várias partes. Compacte tudo em um único arquivo.

zip64_unsupported

ZIP64 não é compatível.

zip_trailing_data

Há dados extras depois do fim do arquivo ZIP.

zip_corrupt

O arquivo ZIP está corrompido.

zip_encrypted

O arquivo ZIP está protegido por senha.

zip_unsupported_method

Método de compressão não compatível. São permitidos Stored (sem compressão) e Deflate (o padrão).

zip_header_mismatch

O arquivo compactado se contradiz.

zip_overlap

Há arquivos sobrepostos dentro do arquivo compactado.

zip_crc_mismatch

Checksum incorreto, um arquivo está corrompido.

zip_symlink

Link simbólico no pacote.

zip_bad_name

Nome de arquivo inválido: não ASCII sem UTF-8, ../, caminhos absolutos, caracteres especiais, mais de 180 caracteres ou mais de 8 pastas de profundidade.

zip_duplicate_name

Um arquivo aparece duas vezes no arquivo compactado.

zip_nested_archive

Um arquivo compactado dentro do arquivo compactado (por exemplo, um ZIP dentro do ZIP).

Arquivos e conteúdo

manifest_missing

manifest.json não foi encontrado. Ele precisa estar na raiz do ZIP ou dentro da única pasta dele.

manifest_invalid

manifest.json é inválido. Os erros aparecem logo abaixo (códigos em "Referência do manifest.json").

entry_missing

O arquivo inicial indicado em entry não está no pacote.

file_type_not_allowed

Este tipo de arquivo não é permitido.

file_content_mismatch

O conteúdo não corresponde à extensão (por exemplo, um JPG chamado .png).

file_not_utf8

O arquivo de texto não está salvo em UTF-8.

file_empty

O arquivo está vazio.

external_reference

O arquivo contém o endereço de outro site (com a linha).

forbidden_markup

HTML não permitido (iframe, frame, object, embed, portal, base, meta refresh) ou script em um arquivo SVG.

forbidden_api

Código que contornaria os bloqueios de rede: WebRTC (RTCPeerConnection, STUN/TURN), frames via JavaScript (createElement("iframe"), "<iframe" em strings) ou dicas de conexão (dns-prefetch, preconnect, prerender, prefetch).

Teste automático

test_failed significa que o teste automático ultrapassou pelo menos um limite. Os motivos aparecem logo abaixo, cada um com o valor medido e o limite.

perf_no_ready

O widget nunca se comunicou com o overlay depois de carregar. Geralmente falta <script src="/sdk/v1.js"> ou a página nunca termina de carregar.

perf_ready_slow

Pronto tarde demais: mais de 3000 ms depois que a página carregou.

perf_unresponsive

Não responde à verificação do overlay, ou responde devagar demais (o código trava o navegador).

perf_navigated

O widget saiu da página ou recarregou a própria página.

perf_flood

O widget envia mensagens demais para o overlay.

perf_idle_cpu

Mais de 2 % de CPU enquanto nada acontece.

perf_storm_cpu

Mais de 15 % de CPU com muitos eventos.

perf_heap

Mais de 64 MB de memória.

perf_dom

Mais de 3000 elementos na página.

perf_long_task

Trava o navegador por mais de 200 ms de cada vez.

network_attempt

Tenta carregar algo de outro site (o host é mostrado).

runtime_errors

Só um aviso, não é motivo de reprovação: erros de JavaScript durante o teste. O admin vê o primeiro.

Este artigo foi útil?