大网数据广告活动
Web 标准与前端开发

ServiceWorkerGlobalScope:sync 事件

· 52CE 我爱测

当页面(或 worker)使用 SyncManager 注册的事件正在运行,并且一旦网络连接可用时,将触发 ServiceWorkerGlobalScope 接口的 **`sync`** 事件。

Background Syncservice

当页面(或 worker)使用 SyncManager 注册的事件正在运行,并且一旦网络连接可用时,将触发 ServiceWorkerGlobalScope 接口的 sync 事件。

此事件不能取消,也不会冒泡。

语法

像 EventTarget.addEventListener 一样在方法中使用事件名称,或设置事件处理器属性。

addEventListener("sync", (event) => {});

onsync = (event) => {};

事件类型

SyncEvent。其继承自 ExtendableEvent 和 Event。

SyncEvent

事件属性

自其父级 ExtendableEvent 和 Event 继承属性。

  • SyncEvent.tag
    • : 返回此 SyncEvent 的开发人员定义的标识符。
  • SyncEvent.lastChance
    • : 如果用户代理在当前尝试之后不再进行进一步的同步尝试,则返回 true。

示例

以下示例显示了如何在 Service Worker 中响应同步事件。

self.addEventListener("sync", (event) => {
  if (event.tag === "sync-messages") {
    event.waitUntil(sendOutboxMessages());
  }
});

你也可以通过 onsync 属性设置事件处理器:

self.onsync = (event) => {
  // ...
};

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。