NavigationPreloadManager: disable()-Methode

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit April 2022 browserübergreifend verfügbar.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die disable()-Methode der NavigationPreloadManager-Schnittstelle stoppt das zuvor mit enable() gestartete automatische Vorladen von ressourcen, die vom Service Worker verwaltet werden. Sie gibt ein Promise zurück, das mit undefined aufgelöst wird.

Die Methode kann im activate-Ereignis-Handler des Service Workers aufgerufen werden (bevor der fetch-Ereignis-Handler aufgerufen werden kann).

Syntax

disable()

InvalidStateError DOMException: Es ist kein aktiver Worker mit der Registrierung verbunden, zu der dieser NavigationPreloadManager gehört.

Beispiele

Der folgende Code zeigt, wie man das Vorladen deaktiviert, nachdem man zuerst mit ServiceWorkerRegistration.navigationPreload getestet hat, dass es unterstützt wird.

addEventListener("activate", (event) => {
  event.waitUntil(
    (async () => {
      if (self.registration.navigationPreload) {
        // Disable navigation preloads!
        await self.registration.navigationPreload.disable();
      }
    })(),
  );
});