history.addUrl()
Fügt dem Browserverlauf einen Eintrag für den Besuch der angegebenen URL hinzu. Die Besuchszeit wird als die Zeit des Aufrufs protokolliert, und der TransitionType
wird als "link" aufgezeichnet.
Dies ist eine asynchrone Funktion, die ein Promise
zurückgibt.
Syntax
let addingUrl = browser.history.addUrl(
details // object
)
Parameter
details
-
object
. Objekt, das die hinzuzufügende URL enthält.url
-
string
. Die hinzuzufügende URL. title
Optional-
string: Der Titel der Seite. Wenn dieser nicht angegeben wird, wird der Titel als
null
aufgezeichnet. transition
Optional-
history.TransitionType
. Beschreibt, wie der Browser bei dieser Gelegenheit zu der Seite navigiert ist. Wenn dies nicht angegeben wird, wird ein Übergangstyp von "link" aufgezeichnet. visitTime
Optional-
number
oderstring
oderobject
. Ein Wert, der ein Datum und eine Uhrzeit angibt. Dies kann als: einDate
Objekt, eine ISO 8601 Datumszeichenfolge oder die Anzahl der Millisekunden seit der Epoche dargestellt werden. Legt die Besuchszeit auf diesen Wert fest. Wenn dies nicht angegeben wird, wird die aktuelle Zeit aufgezeichnet.
Rückgabewert
Ein Promise
wird ohne Parameter erfüllt, wenn das Element hinzugefügt wurde.
Browser-Kompatibilität
BCD tables only load in the browser
Beispiele
Fügen Sie einen Eintrag für einen Besuch zu "https://example.org/" hinzu und überprüfen Sie dann, ob der neue Besuch protokolliert wurde, indem Sie den Verlauf nach dem neuesten Element durchsuchen und es protokollieren:
function onGot(results) {
if (results.length) {
console.log(results[0].url);
console.log(new Date(results[0].lastVisitTime));
}
}
browser.history
.addUrl({ url: "https://example.org/" })
.then(() =>
browser.history.search({
text: "https://example.org/",
startTime: 0,
maxResults: 1,
}),
)
.then(onGot);
Fügen Sie einen Eintrag für einen Besuch zu "https://example.org" hinzu, geben Sie jedoch eine visitTime
24 Stunden in der Vergangenheit und einen transition
von "typed" an:
const DAY = 24 * 60 * 60 * 1000;
function oneDayAgo() {
return Date.now() - DAY;
}
function onGot(visits) {
for (const visit of visits) {
console.log(new Date(visit.visitTime));
console.log(visit.transition);
}
}
browser.history
.addUrl({
url: "https://example.org/",
visitTime: oneDayAgo(),
transition: "typed",
})
.then(() =>
browser.history.getVisits({
url: "https://example.org/",
}),
)
.then(onGot);
Hinweis: Diese API basiert auf Chromiums chrome.history
API. Diese Dokumentation ist abgeleitet von history.json
im Chromium-Code.