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