ServiceWorkerContainer: controllerchange event

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.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

Note: This feature is available in Web Workers.

The controllerchange event of the ServiceWorkerContainer interface fires when the document's associated ServiceWorkerRegistration acquires a new active worker.

Syntax

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

js
addEventListener("controllerchange", (event) => {});

oncontrollerchange = (event) => {};

Event type

A generic Event.

Example

js
navigator.serviceWorker.addEventListener("controllerchange", () => {
  console.log("The controller of current browsing context has changed.");
});

Specifications

Specification
Service Workers
# dom-serviceworkercontainer-oncontrollerchange

Browser compatibility

BCD tables only load in the browser