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

Clients

· 52CE 我爱测

`Clients` 接口提供对 Client 对象的访问。通过在 service worker 中使用 `ServiceWorkerGlobalScope.clients` 访问它。

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。离线整理了版式、链接和媒体显示。

资料来源与适用范围

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

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

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