history.deleteUrl()

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

C'est une fonction asynchrone qui renvoie une Promise.

Syntaxe

js
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é des navigateurs

BCD tables only load in the browser

Exemples

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

js
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 à history.onVisitRemoved pour consigner l'URL de la page supprimée :

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

Example extensions

Note :

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.