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);
浏览器兼容性
Loading…
备注: 此 API 基于 Chromium 的 chrome.browsingData
API。