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: 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

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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
disable

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch