MDN self-hosted library · e01.org

ServiceWorkerGlobalScope: activate event

Service Workers APIservice

Service Workers APIservice

The activate event of the ServiceWorkerGlobalScope interface is fired when a ServiceWorkerRegistration acquires a new ServiceWorkerRegistration.active worker.

This event is not cancelable and does not bubble.

Syntax

Use the event name in addEventListener():

addEventListener("activate", (event) => { })

Alternatively, assign to the event handler property of the interface:

onactivate = (event) => { }

Event type

An ExtendableEvent. Inherits from Event.

ExtendableEvent

Examples

The following snippet shows how you could use an activate event handler to upgrade a cache.

self.addEventListener("activate", (event) => {
  const cacheAllowlist = ["v2"];

  event.waitUntil(
    caches.keys().then((cacheNames) =>
      Promise.all(
        cacheNames.map((cacheName) => {
          if (!cacheAllowlist.includes(cacheName)) {
            return caches.delete(cacheName);
          }
          return undefined;
        }),
      ),
    ),
  );
});

You can also set up the event handler using the onactivate property (but note that this replaces other event listeners added using onactivate, if any):

self.onactivate = (event) => {
  // …
};

Specifications

Browser compatibility

See also