ServiceWorkerGlobalScope: install event
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.
Syntax
Use the event name in methods like addEventListener()
, or set an event handler property.
addEventListener('install', event => { });
oninstall = event => { };
Event type
An ExtendableEvent
. Inherits from Event
.
Event properties
Doesn't implement any specific properties, but inherits properties from its parent, Event
.
Examples
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:
this.addEventListener('install', function(event) {
event.waitUntil(
caches.open('v1').then(function(cache) {
return cache.addAll([
'/sw-test/',
'/sw-test/index.html',
'/sw-test/style.css',
'/sw-test/app.js',
'/sw-test/image-list.js',
'/sw-test/star-wars-logo.jpg',
'/sw-test/gallery/',
'/sw-test/gallery/bountyHunters.jpg',
'/sw-test/gallery/myLittleVader.jpg',
'/sw-test/gallery/snowTroopers.jpg'
])
})
);
});
You can also set up the event handler using the oninstall
property:
globalScope.oninstall = function(event) {
...
};
Specifications
Specification |
---|
Service Workers 1 # service-worker-global-scope-install-event |
Browser compatibility
BCD tables only load in the browser