Clients

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

方法

Clients.get()

返回一个匹配给定 id 的 Client 的 Promise .

Clients.matchAll()

返回一个 Client 对象数组的 Promise . options参数允许您控制返回的clients类型. 

Clients.openWindow()

打开给定URL的新浏览器窗口，并返回新 WindowClient a 的 Promise .

Clients.claim()

允许一个激活的 service worker 将自己设置为其scope 内所有 clients 的 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

• Using Service Workers
• Is ServiceWorker ready?
• Promise