ServiceWorkerContainer.register()

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

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 (en-US) 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.

Um Promise (en-US) que resolve com um objeto ServiceWorkerRegistration (en-US).

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!.");
}