ServiceWorkerContainer

Интерфейс ServiceWorkerContainer API сервисных рабочих Service Worker API предоставляет объект, представляющий сервисного рабочего как единицу в экосистеме сети, включая возможности регистрации, отмены регистрации и обновления сервисных рабочих, а также доступ к состоянию сервисных рабочих и их регистраций.

Наиболее важным является метод ServiceWorkerContainer.register(), используемый для регистрации сервисных рабочих, и свойство ServiceWorkerContainer.controller, используемое для определения того, контролируется ли текущая страница активно.

Объекты ServiceWorkerContainer доступны в области видимости окна через Navigator.serviceWorker и в рабочих процессах с помощью WorkerNavigator.serviceWorker (если поддерживается — проверьте совместимость с браузером).

ServiceWorkerContainer.controller Только для чтения

Возвращает объект ServiceWorker, если его состояние activating или activated (тот же объект, возвращаемый ServiceWorkerRegistration.active). Это свойство возвращает null во время запроса принудительной перезагрузки (Shift + перезагрузка) или если нет активного рабочего процесса.

ServiceWorkerContainer.ready Только для чтения

Предоставляет способ отложить выполнение кода до активации сервисного рабочего. Возвращает Promise, который никогда не отклоняется и ожидает неопределенно долго, пока у ServiceWorkerRegistration, связанного с текущей страницей, будет ServiceWorkerRegistration.active рабочий процесс. После того, как это условие выполнено, он разрешается с ServiceWorkerRegistration.

ServiceWorkerContainer.getRegistration()

Возвращает объект ServiceWorkerRegistration, область действия которого соответствует предоставленному URL документа. Метод возвращает Promise, который разрешается в ServiceWorkerRegistration или undefined.

ServiceWorkerContainer.getRegistrations()

Возвращает все объекты ServiceWorkerRegistration, связанные с ServiceWorkerContainer в массиве. Метод возвращает Promise, который разрешается в массив ServiceWorkerRegistration.

ServiceWorkerContainer.register()

Создает или обновляет ServiceWorkerRegistration для данного scriptURL.

ServiceWorkerContainer.startMessages()

Явно запускает поток сообщений, отправляемых из сервисного рабочего в страницы, находящиеся под его управлением (например, отправленные через Client.postMessage()). Это можно использовать для более ранней реакции на отправленные сообщения, даже до завершения загрузки содержимого этой страницы.

controllerchange

Срабатывает, когда у документа связанный ServiceWorkerRegistration получает новый active рабочий процесс.

error Устарело Нестандартно

Срабатывает всякий раз, когда возникает ошибка в связанных сервисных рабочих.

message

Срабатывает, когда принимаемые сообщения получены объектом ServiceWorkerContainer (например, через вызов MessagePort.postMessage()).

messageerror

Срабатывает, когда принимаемые сообщения не могут быть десериализованы объектом ServiceWorkerContainer (например, через вызов MessagePort.postMessage()).

В примере ниже сначала проверяется, поддерживает ли браузер сервисные рабочие. Если поддерживает, код регистрирует сервисного рабочего и определяет, контролируется ли страница активно сервисным рабочим. Если нет, он предлагает пользователю перезагрузить страницу, чтобы сервисный рабочий мог взять контроль. Код также сообщает об ошибках регистрации.

if ("serviceWorker" in navigator) {
  // Register a service worker hosted at the root of the
  // site using the default scope.
  navigator.serviceWorker
    .register("/sw.js")
    .then((registration) => {
      console.log("Service worker registration succeeded:", registration);

      // At this point, you can optionally do something
      // with registration. See https://developer.mozilla.org/en-US/docs/Web/API/ServiceWorkerRegistration
    })
    .catch((error) => {
      console.error(`Service worker registration failed: ${error}`);
    });

  // Independent of the registration, let's also display
  // information about whether the current page is controlled
  // by an existing service worker, and when that
  // controller changes.

  // First, do a one-off check if there's currently a
  // service worker in control.
  if (navigator.serviceWorker.controller) {
    console.log(
      "This page is currently controlled by:",
      navigator.serviceWorker.controller,
    );
  }

  // Then, register a handler to detect when a new or
  // updated service worker takes control.
  navigator.serviceWorker.oncontrollerchange = () => {
    console.log(
      "This page is now controlled by",
      navigator.serviceWorker.controller,
    );
  };
} else {
  console.log("Service workers are not supported.");
}

• Использование Service Workers
• Базовый пример кода Service workers
• Использование web workers