Criar lista de pré-cache para service worker
Cole os caminhos dos arquivos que o site deve guardar para uso offline e receba uma lista limpa e ordenada: /assets/./app.js vira /assets/app.js, uma folha de estilo repetida sai e as cinco entradas do exemplo ficam em 4, com 1 duplicata removida. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Uma instalação confiável de service worker começa com uma lista limpa de arquivos para armazenar em cache. Este gerador recebe caminhos de recursos estáticos, transforma entradas relativas em URLs a partir da raiz, resolve segmentos de ponto seguros, preserva consultas relevantes e remove duplicatas sem alterar a primeira ordem de ocorrência. O resultado traz uma lista de pré-cache pronta para o Cache Storage e contagens úteis para automatizar verificações de build.
Transforme a saída do build em uma lista pronta
Builds web modernos podem produzir HTML, folhas de estilo, partes de JavaScript, fontes, ícones e páginas alternativas em vários diretórios. Copiar esses nomes manualmente para um service worker é demorado e gera divergências sempre que um arquivo muda. A primeira ordem de ocorrência é mantida para facilitar revisões e comparações entre builds.
A resposta também mostra o total final de recursos e quantas duplicatas foram removidas. Esses números ajudam no CI: uma queda inesperada na contagem pode interromper o build antes que uma versão offline incompleta chegue aos usuários. A ferramenta não baixa, identifica nem inspeciona arquivos; ela apenas transforma caminhos obtidos de um processo de build confiável.
Normalização previsível dos caminhos
Caminhos de recursos podem chegar com grafias diferentes mesmo quando apontam para o mesmo arquivo. Por exemplo, <code>assets/app.js</code>, <code>/assets/app.js</code> e <code>/assets/./app.js</code> viram <code>/assets/app.js</code>. Barras repetidas são reduzidas, segmentos superiores seguros são resolvidos, espaços externos são removidos e resultados normalizados repetidos são descartados após a primeira ocorrência.
As consultas permanecem porque <code>/app.js? URLs completas e relativas ao protocolo também são recusadas: esta capacidade atende arquivos estáticos do mesmo site, e não recursos de terceiros. Um segmento superior que ultrapasse a raiz causa erro em vez de ser reescrito silenciosamente.
Assim, a saída permanece determinística sem presumir origem de implantação, conteúdo ou disponibilidade externa.
Use a lista com segurança no service worker
Coloque o array retornado na rotina de instalação que abre o cache versionado e chama <code>addAll</code>. Mantenha o nome do cache versionado separadamente, pois o gerador não sabe quando o conteúdo muda sob o mesmo caminho. Se o empacotador inserir hashes nos nomes, forneça os caminhos emitidos; se usar nomes estáveis, altere a versão do cache quando o conteúdo mudar.
Considere a entrada uma lista permitida intencional: inclua a estrutura do aplicativo e os recursos necessários para uso offline, mas evite páginas pessoais, respostas autenticadas ou URLs dinâmicas ilimitadas. Uma lista grande aumenta o tempo de download e o risco de falha em conexões instáveis. O limite defensivo é de 10,000 entradas, embora uma lista de produção deva ser muito menor.
Na ativação, exclua versões antigas conforme sua política. Esta ferramenta apenas cria a lista; não gera eventos, escolhe estratégias, acessa a rede nem modifica um service worker existente.
Casos de uso
Gere a lista da estrutura do app
Normalize caminhos de HTML, CSS, JavaScript, fontes e ícones necessários para iniciar um aplicativo web progressivo offline.
Confira artefatos no CI
Converta nomes coletados em uma saída estável e valide as contagens antes da implantação.
Limpe uma lista manual
Resolva caminhos relativos inconsistentes e remova duplicatas acidentais preservando a ordem de instalação.
Perguntas frequentes
Quanto custa?
O mesmo gerador determinístico também pode ser executado no seu navegador nesta página.
A ferramenta baixa ou verifica os recursos?
Não. Ela valida e normaliza caminhos sem fazer solicitações de rede nem verificar se os arquivos existem.
Por que as consultas são preservadas?
Uma consulta pode selecionar outra chave ou versão de cache; removê-la poderia unir recursos que deveriam ficar separados.
Por que URLs remotas são recusadas?
A capacidade cria uma lista estática do mesmo site. Cache entre origens exige decisões explícitas sobre disponibilidade, CORS, privacidade e falhas.
Existe limite de caminhos na lista?
A ferramenta aceita até 10.000 entradas como limite de segurança, mas uma lista de produção deve ser bem menor. Quanto maior a lista de instalação, mais demora o download e maior a chance de a instalação falhar em conexões instáveis.
Ferramentas relacionadas
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/web/service-worker-cache-list-build \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"paths":["/","/assets/app.css","assets/app.js","/icons/icon-192.png"]}'const res = await fetch("https://api.kit.forhosting.com/web/service-worker-cache-list-build", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"paths": [
"/",
"/assets/app.css",
"assets/app.js",
"/icons/icon-192.png"
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/web/service-worker-cache-list-build",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"paths": [
"/",
"/assets/app.css",
"assets/app.js",
"/icons/icon-192.png"
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/web/service-worker-cache-list-build", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"paths":["/","/assets/app.css","assets/app.js","/icons/icon-192.png"]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"paths":["/","/assets/app.css","assets/app.js","/icons/icon-192.png"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/web/service-worker-cache-list-build", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"paths": [
"/",
"/assets/app.css",
"assets/app.js",
"/icons/icon-192.png"
]
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "web.service_worker_cache_list_build",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Limites
timeout_sec | 30 |
max_crawl_pages | 25 |
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
Notas técnicas
Transforme a saída do build em uma lista pronta
Informe os caminhos estáticos na ordem desejada de busca e o gerador devolverá uma lista de pré-cache para service worker na chave <code>precache_manifest</code>. Cada item será uma URL local relativa à raiz, portanto você poderá passar o array diretamente para <code>cache.addAll(precache_manifest)</code> durante o evento de instalação.
Normalização previsível dos caminhos
v=41</code> e <code>/app.js? v=42</code> podem representar chaves de cache distintas. Fragmentos são recusados, pois não seguem nas solicitações HTTP e podem aparentar recursos diferentes sem identificar outra resposta de rede.
Perguntas técnicas
Posso passar o resultado diretamente para cache.addAll?
Sim. O valor precache_manifest é um array de URLs locais adequado ao método addAll do Cache Storage.
O que acontece se a lista estiver vazia?
A solicitação falha com invalid_input, pois uma lista de pré-cache vazia não cumpre a finalidade desta capacidade.