SyncManager インターフェイスの register() メソッドは、同期イベントを登録します。このイベントは、ネットワーク接続が利用可能になるとすぐに、関連付けられたサービスワーカー内で sync イベントを発生させます。

構文

引数

tag

同期イベントの識別子です。これは、サービスワーカーの sync イベントのハンドラーに渡される SyncEvent の tag プロパティの値になります。

返値

undefined で解決する Promise です。

例外

InvalidStateError DOMException

現在のサービスワーカーがアクティブでないとき投げられます。

NotAllowedError DOMException

バックグラウンド同期がユーザーにより無効化されているとき投げられます。

例

以下の非同期関数は、ブラウジングコンテキストからバックグラウンド同期を登録します。

async function syncMessagesLater() {
  const registration = await navigator.serviceWorker.ready;
  try {
    await registration.sync.register("sync-messages");
  } catch {
    console.log("バックグラウンド同期の登録に失敗しました！");
  }
}

仕様書

ブラウザーの互換性