ServiceWorkerGlobalScope: periodicSync 事件

可用性有限

此特性不是基線特性，因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性： 這是一項實驗性技術
在生產中使用此技術之前，請仔細檢查瀏覽器相容性表格。

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

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

ServiceWorkerGlobalScope 介面的 periodicSync 事件在註冊 PeriodicSyncManager 時指定的、固定的時間間隔觸發。

此事件不可取消，也不會冒泡。

語法

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

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

onperiodicsync = (event) => { }

繼承自其祖類 Event 的屬性.

PeriodicSyncEvent.tag 只讀: 返回此 PeriodicSyncEvent 的開發者定義的識別符號。Web 應用可以使用多個 tag 來以不同的頻率執行不同的週期性任務。

以下示例展示瞭如何在 service worker 中響應週期性同步事件。

self.addEventListener("periodicsync", (event) => {
  if (event.tag === "get-latest-news") {
    event.waitUntil(fetchAndCacheLatestNews());
  }
});

您也可以使用 onperiodicSync 屬性來設定事件處理程式

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

規範
Web 週期性後臺同步 # periodicSync-event
Web 週期性後臺同步 # dom-serviceworkerglobalscope-onperiodicsync

此頁面最後修改於 2025年9月8日，由 MDN 貢獻者修改。