NavigationPreloadManager: enable() Methode

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 der Schnittstelle NavigationPreloadManager wird verwendet, 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 Event-Handler des Service Workers aufgerufen werden, um sicherzustellen, dass sie vor jedem fetch Event-Handler ausgeführt wird.

Syntax

js
enable()

Parameter

Keine.

Rückgabewert

Ein Promise, das mit undefined aufgelöst wird.

Ausnahmen

InvalidStateError DOMException

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

Beispiele

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

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

Spezifikationen

Specification
Service Workers
# dom-navigationpreloadmanager-enable

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

NavigationPreloadManager.disable()