history.deleteRange()

删除用户在给定时间范围内访问的所有页面的访问记录。如果这删除了对给定页面进行的所有访问，则该页面将不再出现在浏览器历史记录中，并且 history.onVisitRemoved 将为此页面触发。

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

语法

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

参数

range

object. 用于删除访问记录的时间范围的规范。

startTime: number 或 string 或 object. 一个表示日期和时间的数值。它可以表示为：一个 Date 对象，一个 ISO 8601 日期字符串，或自纪元以来的毫秒数。指定范围的开始时间。
endTime: number 或 string 或 object. 一个表示日期和时间的数值。它可以表示为：一个 Date 对象，一个 ISO 8601 日期字符串，或自纪元以来的毫秒数。指定范围的结束时间。

返回值

当范围被删除时，一个 Promise 将在没有任何参数的情况下被执行。

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

示例

删除过去一分钟内进行的所有访问记录

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。