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

Cache.keys()

· 52CE 我爱测

Cache 接口的 **`keys()`** 方法返回一个 Promise ,这个 Promise 将解析为一个Cache 键的数组。

Service Workers API

Cache 接口的 keys() 方法返回一个 Promise ,这个 Promise 将解析为一个Cache 键的数组。

请求将以它们被插入的顺序返回。

[!NOTE] 具有相同 URL 但不同请求头的请求,如果它们的响应头中有 VARY 头部,则他们可以被返回。

语法

cache.keys(request, { options }).then(function (keys) {
  //do something with your array of requests
});

返回值

返回一个解析为 Cache 键数组的 Promise。

参数

  • request
    • : 如果一个相关键被指定,则返对应的 Request 。
  • options
    • : 一个对象,它的属性决定了 keys 操作中的匹配操作是如何执行的。可选的属性有:
      • ignoreSearch: 一个 Boolean 值,指定了匹配操作是否忽略 url 中的查询部分。如果为 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 中进行匹配。注意这个选项会被 Cache.keys() 方法忽略。

示例

caches.open("v1").then(function (cache) {
  cache.keys().then(function (keys) {
    keys.forEach(function (request, index, array) {
      cache.delete(request);
    });
  });
});

规范

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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