ServiceWorkerContainer.startMessages()
startMessages()
は ServiceWorkerContainer
インターフェイスのメソッドで、サービスワーカーからその制御下にあるページに配信されるメッセージの流れを明示的に開始します(例えば、 Client.postMessage()
を介して送信されます)。 これは、ページのコンテンツの読み込みが完了する前であっても、送信されたメッセージに早く反応するために使用できます。
説明
既定では、ページの読み込み中に、ページを制御するサービスワーカーから(Client.postMessage()
を使用して)ページに送信されたすべてのメッセージはキューに入れられ、ページの HTML 文書が読み込まれて解析されると(つまり、 DOMContentLoaded
イベント発生の後に)ディスパッチされます。 例えば、ページの読み込みが完了する前に EventTarget.addEventListener()
を使用してメッセージハンドラーを呼び出したが、すぐにメッセージの処理を開始したい場合は、ServiceWorkerContainer.startMessages()
を呼び出すことで、これらのメッセージの配信を開始できます。
メモ: onmessage
を使用してハンドラーを直接設定すると、メッセージの送信が自動的に開始されます。 この場合、startMessages()
は必要ありません。
構文
js
startMessages()
引数
なし。
返値
undefined
です。
例
js
if ("serviceWorker" in navigator) {
navigator.serviceWorker.register("/sw.js").then(() => {
console.log("サービスワーカーが登録された");
});
}
// …
navigator.serviceWorker.addEventListener("message", (e) => {
// …
});
navigator.serviceWorker.startMessages();
仕様書
Specification |
---|
Service Workers # navigator-service-worker-startMessages |
ブラウザーの互換性
BCD tables only load in the browser