SyncManager: register() メソッド
利用可能性は限定的
この機能はベースラインではありません。最も広く使用されているブラウザーの一部で動作しません。
メモ: この機能はウェブワーカー内で利用可能です。
SyncManager インターフェイスの register() メソッドは、同期イベントを登録します。このイベントは、ネットワーク接続が利用可能になるとすぐに、関連付けられたサービスワーカー内で sync イベントを発生させます。
構文
js
register(tag)
引数
返値
例外
InvalidStateErrorDOMException-
現在のサービスワーカーがアクティブでないとき投げられます。
NotAllowedErrorDOMException-
バックグラウンド同期がユーザーにより無効化されているとき投げられます。
例
以下の非同期関数は、ブラウジングコンテキストからバックグラウンド同期を登録します。
js
async function syncMessagesLater() {
const registration = await navigator.serviceWorker.ready;
try {
await registration.sync.register("sync-messages");
} catch {
console.log("バックグラウンド同期の登録に失敗しました！");
}
}
仕様書
| 仕様書 |
|---|
| Web Background Synchronization # dom-syncmanager-register |