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 будет выполнен без параметров, когда диапазон будет удален.

Совместимость с браузерами

	Рабочие столы						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet
`deleteRange`	Да	79	49	?	Да	Нет	?	?	Нет	?	Нет	?

Примеры

Удаление всех посещений, сделанных за последний час:

const MINUTE = 60 * 1000;

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

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

Примечание: Этот API основан на API chrome.history Chromium. Данная документация основана на history.json кода Chromium.

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/history/deleteRange