此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

browsingData.removeHistory()

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

你可以使用 removalOptions 参数(一个 browsingData.RemovalOptions 对象),用于:

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

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

语法

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

参数

removalOptions

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

返回值

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

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

js
function onRemoved() { console.log("已删除"); } function onError(error) { console.error(error); } browser.browsingData.removeHistory({}).then(onRemoved, onError); 

浏览器兼容性

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