ServiceWorkerContainer：controllerchange 事件

Baseline 已廣泛支援

此功能已成熟，可跨多種裝置和瀏覽器版本工作。它自 ⁨2018 年 4 月⁩ 起已在所有瀏覽器中可用。

安全上下文： 此功能僅在安全上下文（HTTPS）中可用，且支援此功能的瀏覽器數量有限。

注意：此功能在 Web Workers 中可用。

當文件關聯的 ServiceWorkerRegistration 獲取一個新的 active worker 時，ServiceWorkerContainer 介面的 controllerchange 事件就會觸發。

語法

在諸如 addEventListener() 之類的方法中使用事件名稱，或設定事件處理程式屬性。

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

oncontrollerchange = (event) => { }

一個通用的 Event。

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

規範
Service Workers # dom-serviceworkercontainer-oncontrollerchange

此頁面由 MDN 貢獻者最後修改於 ⁨2025 年 5 月 2 日⁩。