NavigationPreloadManager: disable()-Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2018.

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

Hinweis: Dieses Feature ist verfügbar in Web Workers.

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

js
disable()

Parameter

Keine.

Rückgabewert

Ein Promise, das mit undefined aufgelöst wird.

Ausnahmen

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.

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

Spezifikationen

Specification
Service Workers
# dom-navigationpreloadmanager-disable

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch