browsingData.removeHistory()

清除用户访问过的网页记录（浏览历史）。

你可以使用 removalOptions 参数（一个 browsingData.RemovalOptions 对象），用于：

仅清除在特定时间之后访问的网页记录
控制是仅清除普通网页的记录，还是同时清除托管应用程序和扩展程序的记录。

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

语法

let removing = browser.browsingData.removeHistory(
  removalOptions            // RemovalOptions 对象
)

参数

removalOptions: object。一个 browsingData.RemovalOptions 对象，可用于仅清除在特定时间之后访问的网页记录，以及是仅清除普通网页的记录，还是同时清除托管应用程序和扩展程序的记录。

返回值

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

示例

清除上周访问的网页记录：

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

清除所有访问过的网页记录：

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

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

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

浏览器兼容性

BCD tables only load in the browser