ServiceWorkerGlobalScope: install-Ereignis
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 nur in Service Workers verfügbar.
Das install-Ereignis der Schnittstelle ServiceWorkerGlobalScope wird ausgelöst, wenn eine ServiceWorkerRegistration einen neuen ServiceWorkerRegistration.installing-Worker erhält.
Dieses Ereignis kann nicht abgebrochen werden und wird nicht weitergereicht.
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
addEventListener("install", (event) => { })
Alternativ können Sie der Ereignisbehandlungs-Eigenschaft der Schnittstelle einen Wert zuweisen:
oninstall = (event) => { }
Ereignistyp
Ein ExtendableEvent. Erbt von Event.
Beispiele
Der folgende Ausschnitt zeigt, wie sich mit einem install-Ereignis-Handler ein Cache mit mehreren Antworten befüllen lässt, die der Service Worker anschließend verwenden kann, um Ressourcen offline bereitzustellen:
self.addEventListener("install", (event) => {
event.waitUntil(
caches
.open("v1")
.then((cache) =>
cache.addAll([
"/",
"/index.html",
"/style.css",
"/app.js",
"/image-list.js",
"/star-wars-logo.jpg",
"/gallery/",
"/gallery/bountyHunters.jpg",
"/gallery/myLittleVader.jpg",
"/gallery/snowTroopers.jpg",
]),
),
);
});
Sie können den Ereignis-Handler auch über die Eigenschaft oninstall einrichten. Beachten Sie jedoch, dass dadurch gegebenenfalls andere mit oninstall hinzugefügte Ereignis-Listener ersetzt werden:
self.oninstall = (event) => {
// …
};
Spezifikationen
| Spezifikation |
|---|
| Service Workers Nightly # dom-serviceworkerglobalscope-oninstall |