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