ServiceWorkerGlobalScope: install Ereignis
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 nur in Service Workers verfügbar.
Das install
Ereignis des ServiceWorkerGlobalScope
Interfaces wird ausgelöst, wenn eine ServiceWorkerRegistration
einen neuen ServiceWorkerRegistration.installing
Worker erhält.
Dieses Ereignis kann nicht abgebrochen werden und wird nicht weitergegeben.
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
.
Ereigniseigenschaften
Implementiert keine spezifischen Eigenschaften, erbt jedoch Eigenschaften von seinem Elternteil, Event
.
Beispiele
Das folgende Beispiel zeigt, wie ein install
Ereignis-Handler verwendet werden kann, um einen Cache mit einer Reihe von Antworten zu füllen, den der Service Worker dann nutzen kann, um Assets 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 mit der oninstall
Eigenschaft einrichten:
self.oninstall = (event) => {
// ...
};
Spezifikationen
Specification |
---|
Service Workers # dom-serviceworkerglobalscope-oninstall |
Browser-Kompatibilität
BCD tables only load in the browser