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.
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
| Limite | Valor |
|---|---|
| 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
| Medição | Limite |
|---|---|
| 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".
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).
| Código | Significado |
|---|---|
| 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).
| Código | Significado |
|---|---|
| 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.
| Código | Significado |
|---|---|
| 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?