history.deleteRange()

删除用户在给定时间范围内浏览过的所有页面访问记录。如果删除的是某个页面的所有访问记录,那么该页面将不再出现在浏览器历史记录中,并且会触发 history.onVisitRemoved 事件。

这是一个异步函数,返回一个 Promise

语法

js
let deletingRange = browser.history.deleteRange(
  range           // object
)

参数

range

object。指定要删除访问记录的时间范围。

startTime

numberstringobject。表示日期和时间的数值。它可以是:一个 Date 对象、一个 ISO 8601 日期字符串,或者自纪元以来的 毫秒数。指定范围的开始时间。

endTime

numberstringobject。表示日期和时间的数值。它可以是:一个 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