history.deleteUrl()

Удаляет все посещения заданного URL из истории браузера.

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

Синтаксис

let deletingUrl = browser.history.deleteUrl(
  details         // object
)

Параметры

details

object. Объект, содержащий URL, посещения которого нужно удалить.

url: string. URL, посещения которого нужно удалить.

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

При удалении посещений будет выполнен Promise без параметров.

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

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

Примеры

Удаление всех посещений "https://example.org/" из истории, а затем проверка, что этот URL больше не возвращается из history.search():

let urlToRemove = "https://example.org/";

function onGot(results) {
  if (!results.length) {
    console.log(`${urlToRemove} was removed`);
  } else {
    console.log(`${urlToRemove} was not removed`);
  }
}

function onRemoved() {
  let searching = browser.history.search({
    text: urlToRemove,
    startTime: 0
  });

  searching.then(onGot);
}

let deletingUrl = browser.history.deleteUrl({url: urlToRemove});

deletingUrl.then(onRemoved);

Удаление последней посещенной страницы из истории с обработчиком события history.onVisitRemoved для записи URL удаленной страницы:

function onRemoved(removeInfo) {
  if (removeInfo.urls.length) {
    console.log(`Removed: ${removeInfo.urls[0]}`);
  }
}

browser.history.onVisitRemoved.addListener(onRemoved);

function onGot(results) {
  if (results.length) {
    console.log(`Removing: ${results[0].url}`);
    browser.history.deleteUrl({url: results[0].url});
  }
}

let searching = browser.history.search({
  text: "",
  startTime: 0,
  maxResults: 1
});

searching.then(onGot);

Примеры расширений

history-deleter

Примечание: Этот 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/deleteUrl