browsingData.removeHistory()

Очищает записи посещённых веб-страниц (история посещений).

Вы можете использовать параметр removalOptions, который является объектом browsingData.RemovalOptions, для:

очистки только записей о посещённых веб-страницах после определённого времени
управления тем, следует ли очищать только записи обычных веб-страниц или также очищать записи о работающих приложениях и расширениях.

Это асинхронная функция, которая возвращает Promise.

Синтаксис

let removing = browser.browsingData.removeHistory(
  removalOptions            // RemovalOptions object
)

Параметры

removalOptions: object. Объект browsingData.RemovalOptions, который может использоваться для очистки только записей о посещённых веб-страницах после определённого времени, а также для управления тем, следует ли очищать только записи обычных веб-страниц или также записи о работающих приложениях и расширениях.

Возвращаемое значение

A Promise, который будет выполнен без аргументов по завершении удаления. Если произойдёт какая-либо ошибка, обещание будет отклонено с сообщением об ошибке.

Примеры

Удалить записи о страницах, посещённых за последнюю неделю:

function onRemoved() {
  console.log("removed");
}

function onError(error) {
  console.error(error);
}

function weekInMilliseconds() {
  return 1000 * 60 * 60 * 24 * 7;
}

let oneWeekAgo = new Date().getTime() - weekInMilliseconds();

browser.browsingData
  .removeHistory({ since: oneWeekAgo })
  .then(onRemoved, onError);

Удалить все записи о посещённых страницах:

function onRemoved() {
  console.log("removed");
}

function onError(error) {
  console.error(error);
}

browser.browsingData.removeHistory({}).then(onRemoved, onError);

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

	Рабочий стол						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet
`removeHistory`	Да	79	53 Эта функция также удаляет историю загрузок и веб-сервисы.	?	Да	Нет	?	?	85	?	Нет	?

Примечание: Этот API основан на API chrome.browsingData от 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/browsingData/removeHistory