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

Ajoute un enregistrement à l'historique du navigateur d'une visite à l'URL donnée. L'heure de la visite est enregistrée comme l'heure de l'appel, et le {{WebExtAPIRef("history.TransitionType", "TransitionType")}} est enregistré comme "liens".

C'est une fonction asynchrone qui renvoie une Promise.

Syntaxe

var addingUrl = browser.history.addUrl(
  details         // object
)

Paramètres

details
object. Objet contenant l'URL à ajouter.
url
string. L'URL à ajouter.
title{{optional_inline}}
string: Le titre de la page. Si ce n'est pas fourni, le titre sera enregistré comme null.
transition{{optional_inline}}
{{WebExtAPIRef("history.TransitionType")}}. Décrit comment le navigateur a navigué vers la page à cette occasion. Si ce n'est pas fourni, un type de transition de "lien" sera enregistré.
visitTime{{optional_inline}}
number ou string ou object. Cela peut être représenté par: un objet Date, une  chaîne de date ISO 8601, ou le nombre de millisecondes depuis l'époque. Définit le temps de visite à cette valeur. Si ce n'est pas fourni, l'heure actuelle sera enregistrée.

Valeur retournée

Une Promise sera rempli sans paramètres lorsque l'élément a été ajouté.

Compatibilité du navigateur

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

Exemples

Ajoutez un enregistrement d'une visite à "https://example.org/", puis vérifiez que la nouvelle visite a été enregistrée en recherchant l'historique de l'élément le plus récent et en l'enregistrant :

function onGot(results) {
  if (results.length) {
    console.log(results[0].url);
    console.log(new Date(results[0].lastVisitTime));
  }
}

function onAdded() {
  var searching = browser.history.search({
    text: "https://example.org/",
    startTime: 0,
    maxResults: 1
  });
  searching.then(onGot);
}

var addingUrl = browser.history.addUrl({url: "https://example.org/"});
addingUrl.then(onAdded);

Ajouter un enregistrement d'une visite à "https://example.org", mais lui donner une visitTime de 24 heures dans le passé, et une transition  "typed":

const DAY = 24 * 60* 60 * 1000;

function oneDayAgo() {
  return Date.now() - DAY;
}

function onGot(visits) {
  for (visit of visits) {
    console.log(new Date(visit.visitTime));
    console.log(visit.transition);
  }
}

function onAdded() {
  var gettingVisits = browser.history.getVisits({
    url: "https://example.org/"
  });

  gettingVisits.then(onGot);
}

var addingUrl = browser.history.addUrl({
  url: "https://example.org/",
  visitTime: oneDayAgo(),
  transition: "typed"
});

addingUrl.then(onAdded);

{{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.