webNavigation.onCompleted

browser.webNavigation.onCompleted.addListener(
  listener,                   // function
  filter                      // optional object
)
browser.webNavigation.onCompleted.removeListener(listener)
browser.webNavigation.onCompleted.hasListener(listener)

События содержат три функции:

addListener(callback)

Добавляет обработчик к этому событию.

removeListener(listener)

Прекращает прослушивание этого события. Аргумент listener — это обработчик, который необходимо удалить.

hasListener(listener)

Проверяет, зарегистрирован ли обработчик listener для этого события. Возвращает true , если обработчик зарегистрирован, и false в противном случае.

callback

Функция, которая будет вызвана при возникновении события. Функции будут переданы следующие аргументы:

details

object. Детали о событии навигации. Подробнее см. в разделе details.

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

object. Объект, содержащий единственное свойство url, которое является массивом объектов events.UrlFilter. Если вы укажете этот параметр, событие будет срабатывать только при переходах на URL-адреса, которые соответствуют хотя бы одному элементу UrlFilter в массиве. Если этот параметр опущен, событие будет срабатывать для всех переходов.

tabId

integer. Идентификатор вкладки, в которой произошла навигация.

url

string. URL-адрес, на который перешла данная рамка.

processId

integer. Идентификатор процесса, в котором отображается эта вкладка.

frameId

integer. Рамка, в которой произошла навигация. Значение 0 указывает на то, что навигация произошла в главном контексте просмотра вкладки, а не во вложенном <iframe>. Положительное значение указывает, что навигация произошла во вложенном iframe. Идентификаторы рамок уникальны для данной вкладки и процесса.

timeStamp

number. Время завершения загрузки страницы в миллисекундах с начала эпохи Unix time.

Выводит целевые URL для onCompleted, если имя хоста целевого URL содержит «example.com» или начинается с «developer».

const filter = {
  url:
  [
    {hostContains: "example.com"},
    {hostPrefix: "developer"}
  ]
}

function logOnCompleted(details) {
  console.log(`onCompleted: ${details.url}`);
}

browser.webNavigation.onCompleted.addListener(logOnCompleted, filter);

• navigation-stats