NavigationPreloadManager: disable() メソッド

安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

メモ: この機能はウェブワーカー内で利用可能です。

disable() は NavigationPreloadManager インターフェイスのメソッドで、以前に enable() を使用して開始されたサービスワーカー管理リソースの自動事前読み込みを停止します。 このメソッドは、undefined で解決するプロミスを返します。

このメソッドは、サービスワーカーの activate イベントハンドラー（fetch イベントハンドラーが呼ばれる前）で呼ばれることがあります。

構文

js
disable()

引数

なし。

返値

undefined で解決するプロミス (Promise) です。

例外

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

関連情報

NavigationPreloadManager.enable()