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.


Use the event name in methods like addEventListener(), or set an event handler property.

addEventListener('install', event => { });

oninstall = event => { };

Event type

Event properties

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:

this.addEventListener('install', function(event) {
  event.waitUntil('v1').then(function(cache) {
      return cache.addAll([

You can also set up the event handler using the oninstall property:

globalScope.oninstall = function(event) {


Service Workers 1
# dom-serviceworkerglobalscope-oninstall

Browser compatibility

BCD tables only load in the browser

See also