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