ServiceWorkerRegistration

Интерфейс ServiceWorkerRegistration API сервисных рабочих (Service Worker API) представляет регистрацию сервисного рабочего. Вы регистрируете сервисного рабочего для управления одной или несколькими страницами, которые разделяют один и тот же источник.

Срок существования регистрации сервисного рабочего превышает срок существования объектов ServiceWorkerRegistration, которые представляют их в течение срока жизни соответствующих клиентов сервисного рабочего. Браузер поддерживает постоянный список активных объектов ServiceWorkerRegistration.

Также наследует свойства от своего родительского интерфейса EventTarget.

ServiceWorkerRegistration.active Только для чтения

Возвращает сервисного рабочего, состояние которого activating или activated. Изначально установлено значение null. Активный рабочий будет управлять Client, если URL клиента попадает в область действия регистрации (опция scope установлена при первом вызове ServiceWorkerContainer.register).

ServiceWorkerRegistration.backgroundFetch Только для чтения Экспериментальная

Возвращает ссылку на объект BackgroundFetchManager, который управляет операциями фонового извлечения.

ServiceWorkerRegistration.cookies Только для чтения Экспериментальная

Возвращает ссылку на интерфейс CookieStoreManager, который позволяет подписаться и отписаться от событий изменения куки.

ServiceWorkerRegistration.index Только для чтения Экспериментальная

Возвращает ссылку на интерфейс ContentIndex для управления индексируемым содержимым для просмотра офлайн.

ServiceWorkerRegistration.installing Только для чтения

Возвращает сервисного рабочего, состояние которого installing. Изначально установлено значение null.

ServiceWorkerRegistration.navigationPreload Только для чтения

Возвращает экземпляр NavigationPreloadManager, связанный с текущей регистрацией сервисного рабочего.

ServiceWorkerRegistration.paymentManager Только для чтения Экспериментальная

Возвращает экземпляр PaymentManager приложения для платежей, используемый для управления различными функциями приложения для платежей.

ServiceWorkerRegistration.periodicSync Только для чтения Экспериментальная

Возвращает ссылку на интерфейс PeriodicSyncManager, который позволяет регистрировать задачи для выполнения через определённые интервалы.

ServiceWorkerRegistration.pushManager Только для чтения

Возвращает ссылку на интерфейс PushManager для управления подписками на push-уведомления, включая подписку, получение активной подписки и доступ к статусу разрешения push-уведомлений.

ServiceWorkerRegistration.scope Только для чтения

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

ServiceWorkerRegistration.sync Только для чтения

Возвращает ссылку на интерфейс SyncManager, который управляет процессами фоновой синхронизации.

ServiceWorkerRegistration.updateViaCache Только для чтения

Возвращает значение параметра, определяющего условия, при которых браузер обратится к кэшу HTTP, когда он пытается обновить сервисного рабочего или любые скрипты, импортированные через importScripts(). Может принимать следующие значения: imports, all, или none.

ServiceWorkerRegistration.waiting Только для чтения

Возвращает сервисного рабочего, состояние которого installed. Изначально установлено значение null.

Также наследует методы от своего родительского интерфейса EventTarget.

ServiceWorkerRegistration.getNotifications()

Возвращает список уведомлений в порядке их создания из текущего источника через текущую регистрацию сервисного рабочего.

ServiceWorkerRegistration.showNotification()

Отображает уведомление с запрошенным заголовком.

ServiceWorkerRegistration.unregister()

Отменяет регистрацию сервисного рабочего и возвращает Promise. Сервисный рабочий завершит все текущие операции перед отменением регистрации.

ServiceWorkerRegistration.update()

Проверяет сервер на наличие обновленной версии сервисного рабочего без обращения к кэшам.

updatefound

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

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

if ("serviceWorker" in navigator) {
  navigator.serviceWorker
    .register("/sw.js")
    .then((registration) => {
      registration.addEventListener("updatefound", () => {
        // If updatefound is fired, it means that there's
        // a new service worker being installed.
        const installingWorker = registration.installing;
        console.log(
          "A new service worker is being installed:",
          installingWorker,
        );

        // You can listen for changes to the installing service worker's
        // state via installingWorker.onstatechange
      });
    })
    .catch((error) => {
      console.error(`Service worker registration failed: ${error}`);
    });
} else {
  console.error("Service workers are not supported.");
}

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