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 dies nicht angegeben wird, wird der Titel als null aufgezeichnet.

transition Optional

history.TransitionType. Beschreibt, wie der Browser zu dieser Gelegenheit zur Seite navigiert hat. 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 Zeit angibt. Dies kann wie folgt dargestellt werden: ein Date-Objekt, ein ISO 8601-Datumsstring oder die Anzahl der Millisekunden seit der Epoche. Setzt die Besuchszeit auf diesen Wert. 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 bei "https://example.org/" hinzu und überprüfen Sie dann, ob der neue Besuch aufgezeichnet wurde, indem Sie den Verlauf nach dem aktuellsten 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 bei "https://example.org" hinzu, aber geben Sie 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);