Gerador de service-worker.js

Você quer que a página abra mesmo sem rede, mas escrever um service worker do zero significa acertar três eventos e o ciclo de vida entre eles. Escolha a estratégia (cache-first ou network-first), dê um nome de versão ao cache e liste os arquivos do precache, um por linha. A saída é um service-worker.js completo, com install, activate limpando caches antigos e o fetch já ignorando requisições que não sejam GET.

O install usa addAll, que é tudo ou nada: se um único caminho da lista devolver 404, a instalação inteira falha e o service worker nunca ativa. É de longe a causa mais comum do famoso não registra. Vale saber também que nenhuma das duas estratégias grava resposta nova no cache durante a navegação, só o que estava na lista. É para isso que serve o campo de versão: publicou arquivo novo, troca v1 por v2 e o activate apaga o cache anterior.

Registre com navigator.serviceWorker.register e sirva o arquivo da raiz do site, porque o escopo é a pasta onde ele está: em /js/ ele só controla /js/. Exige HTTPS, com localhost como exceção. O código gerado chama skipWaiting e clients.claim, então a versão nova assume na hora, enquanto a aba aberta ainda roda o JavaScript antigo; se preferir a troca só no próximo carregamento, apague essas duas linhas. A geração é local.