browsingData.remove()

删除指定的浏览数据。

要删除的浏览数据在 dataTypes 选项中指定，该选项是一个 browsingData.DataTypeSet 对象。

您可以使用 removalOptions 选项，它是一个 browsingData.RemovalOptions 对象，来控制要删除数据的历史时间范围，以及是否只从普通网页中删除数据，还是从托管应用程序和扩展中删除数据。

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

语法

let removing = browser.browsingData.remove(
  removalOptions,            // RemovalOptions object
  dataTypes                  // DataTypeSet object
)

参数

removalOptions: object。一个 browsingData.RemovalOptions 对象，可用于控制删除数据的历史时间范围，以及是否从托管 Web 应用程序和扩展中删除数据，或仅从普通网页中删除数据。
dataTypes: object。一个 browsingData.DataTypeSet 对象，描述要删除的数据类型（例如历史记录、下载等）。

返回值

一个 Promise，当删除完成时，该 Promise 将以不带参数的方式完成。如果发生任何错误，则该 Promise 将被拒绝并显示错误消息。

示例

删除过去一周的下载历史记录和浏览历史记录

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
  .remove({ since: oneWeekAgo }, { downloads: true, history: true })
  .then(onRemoved, onError);

删除所有下载和浏览历史记录

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

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

browser.browsingData
  .remove({}, { downloads: true, history: true })
  .then(onRemoved, onError);

示例扩展

忘记它

浏览器兼容性

BCD 表仅在浏览器中加载

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