ServiceWorkerRegistration: unregister() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit April 2018 browserübergreifend verfügbar.
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
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:
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
| Spezifikation |
|---|
| Service Workers Nightly # navigator-service-worker-unregister |