webNavigation.onCommitted

browser.webNavigation.onCommitted.addListener(
  listener,                 // function
  filter                    // optional object
)
browser.webNavigation.onCommitted.removeListener(listener)
browser.webNavigation.onCommitted.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. Идентификаторы фреймов уникальны для заданной вкладки и процесса.

parentFrameId

integer. Идентификатор родительского фрейма. Установлено значение -1 , если это фрейм верхнего уровня.

timeStamp

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

transitionType

transitionType. Причина навигации. (Например, "link" , если пользователь щелкнул по ссылке, или "reload" , если пользователь перезагрузил страницу.)

transitionQualifiers

Array значений transitionQualifier. Дополнительная информация о навигации: например, был ли серверный или клиентский редирект.

Выводит целевые URL-адреса и дополнительную информацию о переходе для onCommitted, если имя хоста целевого URL-адреса содержит "example.com" или начинается с "developer".

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

function logOnCommitted(details) {
  console.log(`target URL: ${details.url}`);
  console.log(`transition type: ${details.transitionType}`);
  console.log(`transition qualifiers: ${details.transitionQualifiers}`);
}

browser.webNavigation.onCommitted.addListener(logOnCommitted, filter);

• navigation-stats