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. title
Facultatif-
string: Le titre de la page. Si ce n'est pas fourni, le titre sera enregistré comme
null
. transition
Facultatif-
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
Facultatif-
number
oustring
ouobject
. Cela peut être représenté par: un objetDate
, 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 :
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.
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.