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

js
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

BCD tables only load in the browser

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 :

js
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":

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

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.