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