Spec-Zone.ru › Web APIs

PeriodicSyncManager: метод register()

Экспериментально: Это экспериментальная технология
Перед использованием в продакшене тщательно проверьте таблицу совместимости браузеров.

Примечание: Эта функция доступна в Web Workers.

Метод register() интерфейса PeriodicSyncManager регистрирует запрос на периодическую синхронизацию в браузере со указанным тегом и параметрами. Он возвращает Promise, который выполняется, когда регистрация завершена.

Синтаксис

register(tag, options)

Параметры

tag

Уникальный идентификатор типа String.

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

Объект Object содержащий следующие необязательные данные:

minInterval

Минимальное время интервала в миллисекундах, через которое должна происходить периодическая синхронизация.

Возвращаемое значение

Возвращает Promise, который разрешается значением undefined.

Исключения

InvalidStateError DOMException

Возвращается, если нет активного ServiceWorker.

NotAllowedError DOMException

Возвращается, если разрешение на фоновую периодическую синхронизацию не предоставлено.

InvalidAccessError DOMException

Возвращается, если активное окно не является основным окном (не типа auxiliary или top-level).

Примеры

Следующая асинхронная функция регистрирует периодическую фоновую синхронизацию с минимальным интервалом в один день из контекста просмотра:

async function registerPeriodicNewsCheck() {
  const registration = await navigator.serviceWorker.ready;
  try {
    await registration.periodicSync.register("fetch-news", {
      minInterval: 24 * 60 * 60 * 1000,
    });
  } catch {
    console.log("Periodic Sync could not be registered!");
  }
}

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

Спецификация
Веб-периодическая фоновая синхронизация
# dom-periodicsyncmanager-register

Совместимость браузеров

Рабочий стол Мобильный
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
register 80 80 Нет 67 Нет 80 Нет 57 Нет 13.0 Нет

См. также

  • Более богатые автономные возможности с API периодической фоновой синхронизации
  • Демонстрационное приложение Periodic Background Sync

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/PeriodicSyncManager/register

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API