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

js
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 oder string oder object. Ein Wert, der ein Datum und eine Uhrzeit angibt. Dies kann als: ein Date 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:

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

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