browsingData.remove()

移除指定的浏览数据。

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

您可以使用 removalOptions 选项,它是一个 browsingData.RemovalOptions 对象,来控制清除数据的时限,以及是仅从普通网页移除数据,还是同时从托管应用和扩展中移除数据。

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

语法

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

参数

removalOptions

object。一个 browsingData.RemovalOptions 对象,可用于控制清除数据的时限,以及是否从托管的 Web 应用和扩展中移除数据,或者仅从普通网页中移除数据。

dataTypes

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

返回值

一个 Promise,当移除完成后,它将不带参数地被 fulfilled。如果发生任何错误,该 Promise 将会使用错误消息被 rejected。

示例

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

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

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

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

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

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

扩展程序示例

浏览器兼容性

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