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 gebubbelt.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignis-Handler-Eigenschaft.
addEventListener("install", (event) => { })
oninstall = (event) => { }
Ereignistyp
Ein ExtendableEvent. Erbt von Event.
Beispiele
Das folgende Snippet zeigt, wie ein install-Ereignishandler verwendet werden kann, um einen Cache mit einer Reihe von Antworten zu füllen, die der Service-Worker dann verwenden kann, um Inhalte 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 Ereignishandler auch über die oninstall-Eigenschaft festlegen:
self.oninstall = (event) => {
// …
};
Spezifikationen
| Spezifikation |
|---|
| Service Workers Nightly # dom-serviceworkerglobalscope-oninstall |