The install
event of the ServiceWorkerGlobalScope
interface is fired when a ServiceWorkerRegistration
acquires a new ServiceWorkerRegistration.installing
worker.
This event is not cancelable and does not bubble.
The install
event of the ServiceWorkerGlobalScope
interface is fired when a ServiceWorkerRegistration
acquires a new ServiceWorkerRegistration.installing
worker.
This event is not cancelable and does not bubble.
Use the event name in methods like addEventListener()
, or set an event handler property.
js
addEventListener("install", (event) => {}); oninstall = (event) => {};
An ExtendableEvent
. Inherits from Event
.
Doesn't implement any specific properties, but inherits properties from its parent, Event
.
The following snippet shows how an install
event handler can be used to populate a cache with a number of responses, which the service worker can then use to serve assets offline:
js
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", ]), ), ); });
You can also set up the event handler using the oninstall
property:
js
self.oninstall = (event) => { // ... };
Specification |
---|
Service Workers # dom-serviceworkerglobalscope-oninstall |
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
install_event |
40 | 17 | 44 | No | 24 | 11.1 | 40 | 40 | 44 | 24 | 11.3 | 4.0 |
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/ServiceWorkerGlobalScope/install_event