browsingData.remove()

移除指定的浏览数据。

要移除的浏览数据在 dataTypes 选项(一个 browsingData.DataTypeSet 对象)中指定。

你可以使用 removalOptions 选项(一个 browsingData.RemovalOptions 对象)来控制移除数据的时间跨度以及是否仅从普通网页中移除数据,还是同时从托管的应用程序和扩展中移除数据。

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

语法

js
let removing = browser.browsingData.remove(
  removalOptions,            // RemovalOptions 对象
  dataTypes                  // DataTypeSet 对象
)

参数

removalOptions

object。一个 browsingData.RemovalOptions 对象,可用于控制要移除的数据的时间跨度,以及是否从托管的 Web 应用程序和扩展中移除数据,还是仅从普通网页中移除数据。

dataTypes

object。一个 browsingData.DataTypeSet 对象,描述要移除的数据类型(例如历史记录、下载等)。

返回值

一个 Promise,在移除完成时其会兑现且不带任何参数。如果发生任何错误,Promise 将被拒绝,并附带一个错误消息。

示例

删除最近一周的下载历史和浏览历史:

js
function onRemoved() {
  console.log("已删除");
}

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);

删除所有下载和浏览历史:

js
function onRemoved() {
  console.log("已删除");
}

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

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

Example extensions

浏览器兼容性

BCD tables only load in the browser

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