Cache:delete() 方法

安全上下文:此功能仅在安全上下文(HTTPS)中可用,在某些或所有支持的浏览器中可用。

注意:此功能在Web Workers中可用。

delete() 方法是 Cache 接口的方法,它查找键为请求的 Cache 条目,如果找到,则删除该 Cache 条目并返回一个 Promise,该 Promise 解析为 true。如果未找到 Cache 条目,则解析为 false

语法

js
delete(request)
delete(request, options)

参数

request

要删除的 Request。这可以是 Request 对象或 URL。

options 可选

一个对象,其属性控制 delete 操作中如何进行匹配。可用的选项是

ignoreSearch

一个布尔值,指定匹配过程是否应该忽略 URL 中的查询字符串。如果设置为 true,则在执行匹配时会忽略 http://foo.com/?value=bar 中的 ?value=bar 部分。默认为 false

ignoreMethod

一个布尔值,当设置为 true 时,会阻止匹配操作验证 RequestHTTP 方法(通常只允许 GETHEAD)。默认为 false

ignoreVary

一个布尔值,当设置为 true 时,会告诉匹配操作不要执行 VARY 标头匹配。换句话说,如果 URL 匹配,无论 Response 对象是否具有 VARY 标头,您都将获得匹配。默认为 false

cacheName

一个字符串,表示要在其中搜索的特定缓存。请注意,此选项会被 Cache.delete() 忽略。

返回值

一个 Promise,如果缓存条目被删除,则解析为 true,否则解析为 false

示例

js
caches.open("v1").then((cache) => {
  cache.delete("/images/image.png").then((response) => {
    someUIUpdateFunction();
  });
});

规范

规范
Service Workers
# cache-delete

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅