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

Cache.matchAll()

· 52CE 我爱测

Cache 接口的 **`matchAll()`** 方法返回一个 Promise ,其 resolve 为 Cache 对象中所有匹配请求的数组。

Service Workers API

Cache 接口的 matchAll() 方法返回一个 Promise ,其 resolve 为 Cache 对象中所有匹配请求的数组。

语法

cache.matchAll(request, { options }).then(function (response) {
  //do something with the response array
});

返回值

一个 Promise,resolve 为 Cache 对象中所有匹配请求的数组。

[!NOTE] Cache.match() 基本上与Cache.matchAll() 相同,除了它 resolve 为 response[0] (即第一个匹配响应) 而不是 response (数组中所有匹配的响应)。

参数

  • request
    • : Cache 中你尝试查找的 The Request . 如果忽略这一参数,你将获取到 cache 中所有 response 的副本。
  • options
    • : 一个选项对象,允许你为 match 操作中要做的匹配设置特定控制选项。可用选项包括:
      • ignoreSearch: 一个 Boolean 值用来设置匹配操作是否忽略 url 中的 query 部分。如果该参数设置为 true ,那么 http://foo.com/?value=bar 中的 ?value=bar 部分就会在匹配中被忽略。该选项默认为 false。
      • ignoreMethod: 一个 Boolean 值,如果设置为 true在匹配时就不会验证 Request 对象的http 方法 (通常只允许是 GET 或 HEAD 。) 该参数默认值为 false。
      • ignoreVary: 一个 Boolean 值,该值如果为 true 则匹配时不进行 VARY 部分的匹配。例如,如果一个 URL 匹配,此时无论Response对象是否包含VARY头部,都会认为是成功匹配。该参数默认为 false。
      • cacheName: 一个 String ,代表一个具体的要被搜索的缓存。注意该选项被 Cache.matchAll() 方法忽略。

示例

caches.open("v1").then(function (cache) {
  cache.matchAll("/images/").then(function (response) {
    response.forEach(function (element, index, array) {
      cache.delete(element);
    });
  });
});

规范

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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