Service Workers API
Clients 接口提供对 Client 对象的访问。通过在 service worker 中使用 ServiceWorkerGlobalScope.clients 访问它。
方法
- Clients.get()
- : 返回一个匹配给定 Client.id 的 Client 的 Promise .
- Clients.matchAll()
- : 返回一个 Client 对象数组的 Promise . options 参数允许你控制返回的 clients 类型。
- Clients.openWindow()
- : 打开给定 URL 的新浏览器窗口,并返回新 WindowClient a 的 Promise .
- Clients.claim()
- : 允许一个激活的 service worker 将自己设置为其ServiceWorkerRegistration.scope 内所有 clients 的 ServiceWorkerContainer.controller .
示例
下面示例显示一个已有的聊天窗口,或者当用户点击通知时创建新的窗口。
addEventListener("notificationclick", (event) => {
event.waitUntil(
(async function () {
const allClients = await clients.matchAll({
includeUncontrolled: true,
});
let chatClient;
// Let's see if we already have a chat window open:
for (const client of allClients) {
const url = new URL(client.url);
if (url.pathname == "/chat/") {
// Excellent, let's use it!
client.focus();
chatClient = client;
break;
}
}
// If we didn't find an existing chat window,
// open a new one:
if (!chatClient) {
chatClient = await clients.openWindow("/chat/");
}
// Message the client:
chatClient.postMessage("New chat messages!");
})(),
);
});
规范
浏览器兼容性
See also
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
