NavigationPreloadManager: enable()-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 enable()-Methode des NavigationPreloadManager-Interfaces wird genutzt, um das Vorladen von Ressourcen zu aktivieren, die vom Service Worker verwaltet werden. Sie gibt ein Promise zurück, das mit undefined aufgelöst wird.

Die Methode sollte im activate-Ereignishandler des Service Workers aufgerufen werden, was sicherstellt, dass sie ausgeführt wird, bevor jeglicher fetch-Ereignishandler ausgelöst werden kann.

Syntax

enable()

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

Beispiele

Der untenstehende Code zeigt, wie man das Vorladen aktiviert, nachdem zuvor mit ServiceWorkerRegistration.navigationPreload überprüft wurde, ob es unterstützt wird.

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