history.deleteRange()

Removes all visits to pages that the user made during the given time range. If this removes all visits made to a given page, then the page will be no longer appear in the browser history and history.onVisitRemoved will fire for it.

This is an asynchronous function that returns a Promise.

Syntax

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

Parameters

range

object. Specification of the time range for which to delete visits.

startTime

number or string or object. A value indicating a date and time. This can be represented as: a Date object, an ISO 8601 date string, or the number of milliseconds since the epoch. Specifies the start time for the range.

endTime

number or string or object. A value indicating a date and time. This can be represented as: a Date object, an ISO 8601 date string, or the number of milliseconds since the epoch. Specifies the end time for the range.

Return value

A Promise will be fulfilled with no parameters when the range has been deleted.

Browser compatibility

Examples

Delete all visits made in the last minute:

js
const MINUTE = 60 * 1000;

function oneMinuteAgo() {
  return Date.now() - MINUTE;
}

browser.history.deleteRange({
  startTime: oneMinuteAgo(),
  endTime: Date.now(),
});

Note: This API is based on Chromium's chrome.history API. This documentation is derived from history.json in the Chromium code.