--- title: history.deleteUrl() slug: Mozilla/Add-ons/WebExtensions/API/history/deleteUrl tags: - API - Add-ons - Extensions - History - Method - Non-standard - Reference - WebExtensions - deleteUrl translation_of: Mozilla/Add-ons/WebExtensions/API/history/deleteUrl ---
{{AddonSidebar()}}

Supprime toutes les visites à l'URL donnée de l'historique du navigateur.

C'est une fonction asynchrone qui renvoie une Promise.

Syntaxe

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

Paramètres

details
object. Objet contenant l'URL dont les visites doivent être supprimées.
url
string. L'URL dont les visites doivent être supprimées.

Valeur retournée

Une Promise sera remplie sans paramètres lorsque les visites auront été supprimées.

Compatibilité du navigateur

{{Compat("webextensions.api.history.deleteUrl")}}

Exemples

Supprimez toutes les visites de "https://example.org/" de l'historique, puis vérifiez que cette URL n'est plus renvoyée par {{WebExtAPIRef("history.search()")}}:

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

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

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

  searching.then(onGot);
}

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

deletingUrl.then(onRemoved);

Supprimez la dernière page visitée de l'historique, avec un écouteur à {{WebExtAPIRef("history.onVisitRemoved")}} pour consigner l'URL de la page supprimée :

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});
  }
}

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

searching.then(onGot);

{{WebExtExamples}}

Remerciements :

Cette API est basée sur l'API Chromium chrome.history. Cette documentation est dérivée de history.json dans le code de Chromium.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.