history.addUrl()

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 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.
titleFacultatif: string: Le titre de la page. Si ce n'est pas fourni, le titre sera enregistré comme null.
transitionFacultatif: 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é.
visitTimeFacultatif: 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é des navigateurs

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

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.

Help improve MDN

Learn how to contribute

Cette page a été modifiée le ⁨7 sept. 2025⁩ par les contributeurs du MDN.

View this page on GitHub • Report a problem with this content