history.addUrl()

details

object. Объект, содержащий URL для добавления.

url

string. URL для добавления.

title Необязательно

строка: Заголовок страницы. Если этот параметр не указан, заголовок будет записан как null.

transition Необязательно

history.TransitionType. Описывает, как браузер перешел на страницу в данном случае. Если этот параметр не указан, тип перехода будет записан как "ссылка".

visitTime Необязательно

number или string или object. Значение, указывающее дату и время. Это может быть: объект Date, строка даты и времени в формате ISO 8601, или число миллисекунд, прошедших с начала эпохи. Устанавливает время посещения на это значение. Если этот параметр не указан, будет записано текущее время.

Значение Promise будет выполнено без параметров, когда элемент будет добавлен.

Добавление записи о посещении "https://example.org/", затем проверка, что новое посещение было записано, путем поиска в истории самого последнего элемента и его вывода:

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

Добавление записи о посещении "https://example.org", но с временем 24 часа в прошлом, и типом перехода "ввод с клавиатуры":

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