NavigationPreloadManager: disable() メソッド
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
メモ: この機能はウェブワーカー内で利用可能です。
disable()
は NavigationPreloadManager
インターフェイスのメソッドで、以前に enable()
を使用して開始されたサービスワーカー管理リソースの自動事前読み込みを停止します。
このメソッドは、undefined
で解決するプロミスを返します。
このメソッドは、サービスワーカーの activate
イベントハンドラー(fetch
イベントハンドラーが呼ばれる前)で呼ばれることがあります。
構文
js
disable()
引数
なし。
返値
例外
InvalidStateError
DOMException
-
この
NavigationPreloadManager
が属する登録に関連するアクティブなワーカーがない場合。
例
下記のコードは最初に ServiceWorkerRegistration.navigationPreload
の使用に対応していることを確認した後、事前読み込みを無効にする方法を示しています。
js
addEventListener("activate", (event) => {
event.waitUntil(
(async () => {
if (self.registration.navigationPreload) {
// Disable navigation preloads!
await self.registration.navigationPreload.disable();
}
})(),
);
});
仕様書
Specification |
---|
Service Workers # dom-navigationpreloadmanager-disable |
ブラウザーの互換性
BCD tables only load in the browser