Service Worker APIservice
Client 接口的 postMessage() 方法允许 service worker 向客户端(Window、Worker 或 SharedWorker)发送消息。消息在 ServiceWorkerContainer 上的 message 事件中接收。
语法
postMessage(message)
postMessage(message, transfer)
postMessage(message, options)
参数
-
message -
transfer -
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。离线整理了版式、链接和媒体显示。
