ServiceWorkerGlobalScope: sync イベント
sync
は ServiceWorkerGlobalScope
インターフェイスのイベントで、 SyncManager
にイベントを登録したページ(またはワーカー)が実行されているとき、ネットワーク接続が利用できるようになるとすぐに発行されます。
このイベントはキャンセル不可で、バブリングしません。
構文
このイベント名を addEventListener()
等のメソッドで使用するか、イベントハンドラープロパティを設定するかしてください。
js
addEventListener("sync", (event) => {});
onsync = (event) => {};
イベント型
イベントプロパティ
祖先である Event
からプロパティを継承しています。
SyncEvent.tag
読取専用-
この
SyncEvent
の開発者が定義した識別子を返します。 SyncEvent.lastChance
読取専用-
ユーザーエージェントが現在の同期を試行した後、それ以上同期を試行しない場合には
true
を返します。
例
以下の例は、サービスワーカーで同期イベントに応答する方法を示しています。
js
self.addEventListener("sync", (event) => {
if (event.tag === "sync-messages") {
event.waitUntil(sendOutboxMessages());
}
});
また、 onsync
プロパティを使用して、イベントハンドラーを設定することもできます。
js
self.onsync = (event) => {
// ...
};
仕様書
Specification |
---|
Web Background Synchronization # dom-serviceworkerglobalscope-onsync |
ブラウザーの互換性
BCD tables only load in the browser