Back to Content

ServiceWorkerContainer: controllerchange event

files/en-us/web/api/serviceworkercontainer/controllerchange_event/index.md

latest877 B
Original Source

{{APIRef("Service Workers API")}}{{SecureContext_Header}}{{AvailableInWorkers}}

The controllerchange event of the {{domxref("ServiceWorkerContainer")}} interface fires when the document's associated {{domxref("ServiceWorkerRegistration")}} acquires a new {{domxref("ServiceWorkerRegistration.active","active")}} worker.

Syntax

Use the event name in methods like {{domxref("EventTarget.addEventListener", "addEventListener()")}}, or set an event handler property.

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

oncontrollerchange = (event) => { }

Event type

A generic {{domxref("Event")}}.

Example

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

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}