ServiceWorkerRegistration: updateViaCache-Eigenschaft

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 schreibgeschützte updateViaCache-Eigenschaft der ServiceWorkerRegistration-Schnittstelle gibt den Wert der Einstellung zurück, die bestimmt, unter welchen Umständen der Browser den HTTP-Cache konsultiert, wenn er versucht, den Service Worker oder Skripte, die über importScripts() importiert werden, zu aktualisieren.

Wert

Gibt einen der folgenden Werte zurück:

  • imports, was bedeutet, dass der HTTP-Cache für Aktualisierungen des Service-Worker-Skripts nicht konsultiert wird, aber für Skripte, die mit importScripts() importiert werden, konsultiert wird. Dies ist der Standardwert.
  • all, was bedeutet, dass der HTTP-Cache sowohl für Aktualisierungen des Service-Worker-Skripts als auch für Skripte konsultiert wird, die mit importScripts() importiert werden.
  • none, was bedeutet, dass der HTTP-Cache niemals konsultiert wird.

Beispiele

Das folgende Beispiel zeigt die Verwendung von updateViaCache.

js
if ("serviceWorker" in navigator) {
  navigator.serviceWorker
    .register("/service-worker.js", {
      updateViaCache: "none",
    })
    .then((registration) => {
      registration.addEventListener("updatefound", () => {
        // If updatefound is fired, it means that there's
        // a new service worker being installed.
        console.log(`Value of updateViaCache: ${registration.updateViaCache}`);
      });
    })
    .catch((error) => {
      console.error(`Service worker registration failed: ${error}`);
    });
}

Spezifikationen

Specification
Service Workers
# service-worker-registration-updateviacache

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch