This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

O método register()da interface ServiceWorkerContainer cria ou atualiza um ServiceWorkerRegistration passado em scriptURL.

Em caso de sucesso, um registro de service worker vincula o URL do script fornecido ao escopo, que é usado posteriormente para a navegação correspondente. Você pode chamar esse método incondicionalmente da página controlada. Ou seja, você não precisa primeiro verificar se há um registro ativo.

Há uma frequente confusão em relação ao significado e uso do escopo. Uma vez que um service worker não pode ter um escopo mais amplo do que sua própria localização, use apenas a opção `scope` quando precisar de um escopo mais limitado do que o padrão.

Síntaxe

ServiceWorkerContainer.register(scriptURL, options)
  .then(function(ServiceWorkerRegistration) { ... });

Parâmetros

scriptURL
A URL do script service worker.
options Optional
Um objeto contendo as opções do registro. Atualmente as opções disponíveis são:
  • scope: Uma USVString representando uma URL que define o registro do escopo de um service worker's ; ou seja, o alcance das URLs que o service worker pode controlar. É geralmente uma URL relativa. O valor padrão é o URL que você obtém se você resolvesse './' usando a localização da página web como  base.  Não é, como customa-se acreditar, relativo à localização do service worker. Veja as seções de Exemplos para mais informações sobre como isso funciona.

Valor retornado

Um Promise que resolve com um objeto ServiceWorkerRegistration.

Exemplos

Os exemplos descritos escrito aqui deve ser tomado em conjunto para obter um melhor entendimento de como escopos do service workers são aplicados a uma página. 

O exemplo a seguir usa o valor padrão descope (ao omití-lo). O service worker neste caso irá controlarexample.com/index.html bem como páginas abaixo, como example.com/product/description.html.

if ('serviceWorker' in navigator) {
  // Registra um service worker hospeadado na raiz do
  // site usando o escopo padrão
  navigator.serviceWorker.register('/sw.js').then(function(registration) {
    console.log('Service worker  registrado com sucesso:', registration);
  }).catch(function(error) {
    console.log('Falha ao Registrar o Service Worker:', error);
  });
} else {
  console.log('Service workers não suportado!');
}

O código a seguir,  se incluído em uma página na raiz de um site, seria aplicado  exatamente às mesmas páginas, como no exemplo acima. Lembre-se de que o escopo, quando incluído, usa a localização da página como base. Alternativamente, se esse código foi incluído em uma página example.com/product/description.html,  o escopo de'./' significa que o escopo que o service worker seria aplicado somente  aos recursos deexample.com/product.  Se precisassemos de registrar um service worker em example.com/product/description.html aplicado a todoo example.com, deixaríamos o escopo acima.

if ('serviceWorker' in navigator) {
  // Registre um service worker hospeado na raiz do
  // site usando um escopo mais restritivo.
  navigator.serviceWorker.register('/sw.js', {scope: './'}).then(function(registration) {
    console.log('Service worker registrado com sucesso:', registration);
  }).catch(function(error) {
    console.log('Service worker falhou ao registrar:', error);
  });
} else {
  console.log('Service workers não é suportado pelo navegador!.');
}

Especificações

Especificação Status Comentário
Service Workers
The definition of 'ServiceWorkerContainer' in that specification.
Rascunho editorial Initial definition.

Compatibilidade com Navegadores

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 40 44.0 (44.0)[1] Não suportado 27 Não suportado
Feature Android Webview Chrome for Android Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile
Basic support 40 40 44.0 (44.0) (Yes) Não suportado 27 Não suportado

[1] Os Service workers (e Push) foram desativados no Firefox 45 e 52 Extended Support Releases (ESR.)

Etiquetas do documento e colaboradores

 Colaboradores desta página: wallacemaxters
 Última atualização por: wallacemaxters,