ServiceWorkerContainer.register()

register() метод ServiceWorkerContainer интерфейса который создает и обновляет ServiceWorkerRegistration  для указанного URL js скрипта.

Если удачно, service worker registration связывается по указанному URL js скрипта , который соответственно используется для проверки совпадения при навигации по URL. Если метод не возвращает ServiceWorkerRegistration, он возвращает Promise. Есть возможность вызвать этот метод без проверки на условие, т.е. нет необходимости сначала проверять существует ли активная регистрация в данный момент или нет.

Синтаксис

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

Параметры

scriptURL

URL скрипта service worker - а.

options Необязательный

Опции это обьект  необходимый для регистрации service worker-a. В данный момент доступные опции:

• scope: USVString представляет собой URL который определяет scope service worker - a; Какой диапазон URL может контролировать service worker. Это обычно относительный URL. Значение по умолчанию это URL  котрые соответствует корню т.е. './' используя дирректорию расположения js скрипта service worker -а как основу.

Возвращает

Promise который резолвится в ServiceWorkerRegistration обьект.

Пример использования

if ('serviceWorker' in navigator) {
  navigator.serviceWorker.register('service-worker.js', {scope: './'}).then(function(registration) {
    document.querySelector('#status').textContent = 'succeeded';
  }).catch(function(error) {
    document.querySelector('#status').textContent = error;
  });
} else {
  // The current browser doesn't support service workers.
  var aElement = document.createElement('a');
  aElement.href = 'https://www.chromium.org/blink/serviceworker/service-worker-faq';
  aElement.textContent = 'unavailable';
  document.querySelector('#status').appendChild(aElement);
}

Спецификация

Браузерная совместимость

[1] Использование Service worker ( и Push) приостановлено в Firefox 45 Extended Support Release (ESR.)