ServiceWorkerContainer: ready-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: Diese Funktion ist in Web Workers verfügbar.

Die schreibgeschützte ready-Eigenschaft der ServiceWorkerContainer-Schnittstelle bietet eine Möglichkeit, die Ausführung von Code zu verzögern, bis ein Service Worker aktiv ist.

Die Eigenschaft gibt ein Promise zurück, das niemals zurückgewiesen wird und unbegrenzt wartet, bis die ServiceWorkerRegistration, die mit der aktuellen Seite assoziiert ist, über einen active Worker verfügt. Sobald diese Bedingung erfüllt ist, wird sie mit der entsprechenden ServiceWorkerRegistration aufgelöst.

Wert

Ein Promise, das niemals zurückgewiesen wird und eventuell mit einer ServiceWorkerRegistration aufgelöst wird, wenn ein aktiver Service Worker vorhanden ist.

Beispiele

Code verzögern, bis ein aktiver Service Worker vorhanden ist

js
if ("serviceWorker" in navigator) {
  navigator.serviceWorker.ready.then((registration) => {
    console.log(`A service worker is active: ${registration.active}`);

    // At this point, you can call methods that require an active
    // service worker, like registration.pushManager.subscribe()
  });
} else {
  console.error("Service workers are not supported.");
}

Spezifikationen

Specification
Service Workers
# navigator-service-worker-ready

Browser-Kompatibilität