browsingData.removeCookies()

清除浏览器的 Cookie。

您可以使用removalOptions参数,它是一个browsingData.RemovalOptions对象,以

  • 仅清除在给定时间之后创建的 Cookie
  • 控制是否仅清除普通网页设置的 Cookie,或者也清除托管应用和扩展设置的 Cookie。

这是一个异步函数,它返回一个Promise

语法

js
let removing = browser.browsingData.removeCookies(
  removalOptions            // RemovalOptions object
)

参数

removalOptions

object。一个browsingData.RemovalOptions对象,可用于仅清除在给定时间之后创建的 Cookie,以及是否仅清除普通网页设置的 Cookie,或者也清除托管应用和扩展设置的 Cookie。

返回值

一个Promise,在移除完成时将以无参数的方式完成。如果发生任何错误,则该 Promise 将被拒绝并显示错误消息。

示例

删除过去一周创建的 Cookie

js
function onRemoved() {
  console.log("removed");
}

function onError(error) {
  console.error(error);
}

function weekInMilliseconds() {
  return 1000 * 60 * 60 * 24 * 7;
}

let oneWeekAgo = new Date().getTime() - weekInMilliseconds();

browser.browsingData
  .removeCookies({ since: oneWeekAgo })
  .then(onRemoved, onError);

删除所有 Cookie

警告:使用 API 删除所有 Cookie 将同时清除所有本地存储对象(包括其他扩展的本地存储对象)。

如果您想清除所有 Cookie 而不影响本地存储功能,请使用browser.cookies循环遍历并删除所有 Cookie 存储的内容。

js
function onRemoved() {
  console.log("removed");
}

function onError(error) {
  console.error(error);
}

browser.browsingData.removeCookies({}).then(onRemoved, onError);

浏览器兼容性

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

注意:此 API 基于 Chromium 的chrome.browsingData API。