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

Clients.matchAll()

· 52CE 我爱测

Clients 接口的 **`matchAll()`** 方法返回 service worker Client 对象列表的 `Promise` . 包含 `options` 参数以返回域与关联的 service worker 的域相同所有 service worker 的 clients. 如果未包含 options,该方法仅返回由 service worker 控制的 service worker clients.

Service Workers API

Clients 接口的 matchAll() 方法返回 service worker Client 对象列表的 Promise . 包含 options 参数以返回域与关联的 service worker 的域相同所有 service worker 的 clients. 如果未包含 options,该方法仅返回由 service worker 控制的 service worker clients.

语法

ServiceWorkerClients.matchAll(options).then(function (clients) {
  // do something with your clients list
});

参数

  • options
    • : 一个 options 对象,允许你为匹配操作设置选项。可用选项包括:
      • includeUncontrolled: Boolean — 如果设置为true, 匹配操作将返回与当前服务工作者共享相同源的所有服务工作者客户端。否则,它仅返回由当前服务工作者控制的服务工作者客户端。默认值为false.
      • type: 设置想要匹配的 clients 类型。可用值包括 window, worker, sharedworker, 和 all. 默认是 all.

返回值

resolve 为一个 Client 对象数组的 Promise . 在 Chrome 46/Firefox 54 以及更高版本中,该方法以最近关注的顺序返回 clients , 根据规范更正。

示例

clients.matchAll(options).then(function (clientList) {
  for (var i = 0; i < clients.length; i++) {
    if (clientList[i].url === "index.html") {
      clients.openWindow(clientList[i]);
      // or do something else involving the matching client
    }
  }
});

规范

浏览器兼容性

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

资料来源与适用范围

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

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

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