Conceitos básicos do service worker de extensão

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Os service workers de extensão são instalados e atualizados de maneira diferente dos service workers da Web. Esta página explica essas diferenças.

Registrar service workers

Para registrar um service worker de extensão, especifique-o no campo "background" do arquivo manifest.json. Use a chave "service_worker", que especifica um único arquivo JavaScript. Os service workers em páginas da Web ou apps da Web registram service workers detectando primeiro o recurso serviceWorker em navigator e depois chamando register() dentro da detecção de recursos. Isso não funciona para extensões.

{   "name": "Awesome Test Extension",   ...   "background": {     "service_worker": "service-worker.js"   },   ... }  

Importar scripts

Há dois métodos de importação de scripts para um service worker: a instrução import e o método importScripts(). Não há suporte para import(), que geralmente é chamado de importação dinâmica.

Para usar a instrução import, adicione o campo "type" ao manifesto e especifique "module". Exemplo:

  "background": {     "service_worker": "service-worker.js",     "type": "module"   } 

Em seguida, use import normalmente. As declarações de importação não são compatíveis.

import { tldLocales } from './locales.js'; 

Use importScripts() como faria em um worker de serviço da Web.

importScripts('locales.js'); 

Atualizar

Para atualizar o service worker, publique uma nova versão da sua extensão na Chrome Web Store. Não é possível contornar isso carregando a extensão de um servidor. Por motivos de segurança, o Manifest V3 não oferece suporte a códigos hospedados remotamente. Seu service worker precisa fazer parte do pacote de extensão.