ContentIndex:delete() 方法

实验性: 这是一个 实验性技术
在生产环境中使用此功能之前,请仔细查看 浏览器兼容性表

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

delete() 方法是 ContentIndex 接口的方法,用于从当前已编入索引的内容中注销一项。

注意:调用 delete() 仅影响索引。它不会从 Cache 中删除任何内容。

语法

js
delete(id)

参数

id

您希望 ContentIndex 对象移除的已编入索引内容的唯一标识符。

返回值

返回一个 Promise,该 Promise 解析为 undefined

异常

不会抛出任何异常。

示例

以下是一个异步函数,它从 内容索引 中删除一项。我们收到对当前 ServiceWorkerRegistration 的引用,这使我们能够访问 index 属性,从而访问 delete 方法。

js
async function unregisterContent(article) {
  // reference registration
  const registration = await navigator.serviceWorker.ready;

  // feature detect Content Index
  if (!registration.index) return;

  // unregister content from index
  await registration.index.delete(article.id);
}

delete 方法也可以在 服务工作线程 范围内使用。

js
self.registration.index.delete("my-id");

规范

规范
内容索引
# content-index-delete

浏览器兼容性

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

另请参阅