ServiceWorkerRegistration: unregister() Methode

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 unregister() Methode des ServiceWorkerRegistration Interfaces hebt die Registrierung des Service Workers auf und gibt ein Promise zurück. Das Promise wird auf false aufgelöst, wenn keine Registrierung gefunden wurde, ansonsten auf true, unabhängig davon, ob die Aufhebung der Registrierung stattgefunden hat oder nicht (möglicherweise wird nicht aufgehoben, wenn gerade jemand anderes ServiceWorkerContainer.register() mit demselben Scope aufgerufen hat.) Der Service Worker wird laufende Operationen abschließen, bevor er abgemeldet wird.

Syntax

js
unregister()

Parameter

Keine.

Rückgabewert

Promise löst sich mit einem booleschen Wert auf, der angibt, ob der Service Worker abgemeldet wurde oder nicht.

Beispiele

Das folgende einfache Beispiel registriert ein Service Worker-Beispiel, hebt es dann aber sofort wieder auf:

js
if ("serviceWorker" in navigator) {
  navigator.serviceWorker
    .register("/sw.js", { scope: "/" })
    .then((registration) => {
      // registration worked
      console.log("Registration succeeded.");
      registration.unregister().then((boolean) => {
        // if boolean = true, unregister is successful
      });
    })
    .catch((error) => {
      // registration failed
      console.error(`Registration failed with ${error}`);
    });
}

Spezifikationen

Specification
Service Workers
# navigator-service-worker-unregister

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch