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

Client:postMessage() 方法

· 52CE 我爱测

Client 接口的 **`postMessage()`** 方法允许 service worker 向客户端(Window、Worker 或 SharedWorker)发送消息。消息在 ServiceWorkerContainer 上的 `message` 事件中接收。

Service Worker APIservice

Client 接口的 postMessage() 方法允许 service worker 向客户端(Window、Worker 或 SharedWorker)发送消息。消息在 ServiceWorkerContainer 上的 message 事件中接收。

语法

postMessage(message)
postMessage(message, transfer)
postMessage(message, options)

参数

  • message

    • : 要发送给客户端的消息。可以是任何可结构化克隆的类型。

      [!NOTE] service worker 与其客户端不在同一个代理集群中,因此不能共享内存。SharedArrayBuffer 对象,或以它为底层的缓冲区视图,不能跨代理集群发送。若尝试这样做,接收端会触发包含 DataCloneError DOMException 的 BroadcastChannel/messageerror_event 事件。

  • transfer

    • : 一个可选的可转移对象数组,用于转移这些对象的所有权。这些对象的所有权会交给目标端,发送端将无法再使用它们。这些可转移对象不会自动发送;它们必须包含在消息中,或者接收方能通过其他方式访问到它们,例如通过 MessageEvent.ports 获取 MessagePort。
  • options

    • : 包含以下属性的可选对象:
      • transfer
        • : 与 transfer 参数含义相同。

返回值

无(undefined)。

示例

下面的代码从 service worker 向客户端发送消息。客户端通过 service worker 作用域中的全局对象 ServiceWorkerGlobalScope.clients 上的 Clients.get() 方法获取。

addEventListener("fetch", (event) => {
  event.waitUntil(
    (async () => {
      // 如果我们无法访问该客户端,则提前退出。
      // 例如跨源时。
      if (!event.clientId) return;

      // 获取客户端。
      const client = await self.clients.get(event.clientId);
      // 如果没有拿到客户端,则提前退出。
      // 例如它已关闭。
      if (!client) return;

      // 向客户端发送消息。
      client.postMessage({
        msg: "嘿,我刚收到你发来的 fetch!",
        url: event.request.url,
      });
    })(),
  );
});

接收该消息:

navigator.serviceWorker.addEventListener("message", (event) => {
  console.log(event.data.msg, event.data.url);
});

规范

浏览器兼容性

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

资料来源与适用范围

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

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

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