browsingData.removeHistory()

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

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

  • 仅清除给定时间之后访问的网页记录
  • 控制是否仅清除普通网页的记录，或者是否清除托管应用程序和扩展的记录。

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

语法

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

参数

removalOptions

object。一个 browsingData.RemovalOptions 对象，它可用于仅清除给定时间之后访问的网页记录，以及是否仅清除普通网页的记录，或者是否清除托管应用程序和扩展的记录。

返回值

一个 Promise，它将在删除完成后没有参数地完成。如果发生任何错误，该 promise 将被拒绝并显示错误消息。

示例

删除过去一周访问的网页记录

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

删除所有访问过的网页记录

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

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

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

浏览器兼容性

BCD 表格仅在浏览器中加载

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