history.deleteRange()
删除用户在给定时间范围内浏览过的所有页面访问记录。如果删除的是某个页面的所有访问记录,那么该页面将不再出现在浏览器历史记录中,并且会触发 history.onVisitRemoved 事件。
这是一个异步函数,返回一个 Promise。
语法
js
let deletingRange = browser.history.deleteRange(
range // object
)
参数
range-
object。指定要删除访问记录的时间范围。startTime-
number或string或object。表示日期和时间的数值。它可以是:一个Date对象、一个 ISO 8601 日期字符串,或者自纪元以来的 毫秒数。指定范围的开始时间。 endTime-
number或string或object。表示日期和时间的数值。它可以是:一个Date对象、一个 ISO 8601 日期字符串,或者自纪元以来的 毫秒数。指定范围的结束时间。
返回值
当范围被删除后,一个 Promise 将会被 fulfilled,且不带任何参数。
示例
删除最近一分钟内的所有访问记录
js
const MINUTE = 60 * 1000;
function oneMinuteAgo() {
return Date.now() - MINUTE;
}
browser.history.deleteRange({
startTime: oneMinuteAgo(),
endTime: Date.now(),
});
浏览器兼容性
加载中…
注意: 此 API 基于 Chromium 的 chrome.history API。本文档源自 Chromium 代码中的 history.json。