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。