ServiceWorkerRegistration: unregister() Methode

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 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