ServiceWorkerContainer: controller-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 controller-Eigenschaft des ServiceWorkerContainer-Interfaces gibt ein ServiceWorker-Objekt zurück, wenn dessen Status activating oder activated ist (dasselbe Objekt wird von ServiceWorkerRegistration.active zurückgegeben). Diese Eigenschaft gibt null zurück, wenn die Anfrage ein erzwungener Refresh (Shift + Refresh) ist oder wenn es keinen aktiven Worker gibt.

Wert

Ein ServiceWorker-Objekt.

Beispiele

js
if ("serviceWorker" in navigator) {
  // Do a one-off check to see if a service worker's in control.
  if (navigator.serviceWorker.controller) {
    console.log(
      `This page is currently controlled by: ${navigator.serviceWorker.controller}`,
    );
  } else {
    console.log("This page is not currently controlled by a service worker.");
  }
} else {
  console.log("Service workers are not supported.");
}

Spezifikationen

Specification
Service Workers
# navigator-service-worker-controller

Browser-Kompatibilität

BCD tables only load in the browser