history.addUrl()

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.

Ein Promise wird ohne Parameter erfüllt, wenn das Element hinzugefügt wurde.

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