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.

Mehr erfahren
Vollständige Kompatibilität anzeigen

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 automatische Vorladen von Ressourcen, die vom Service-Worker verwaltet werden, und zuvor mit enable() gestartet wurden. Sie gibt ein Promise zurück, das mit undefined aufgelöst wird.

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

Syntax

disable()

InvalidStateError DOMException: Es gibt keinen aktiven Worker, der mit der Registrierung assoziiert ist, zu der dieser NavigationPreloadManager gehört.

Beispiele

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

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