webNavigation.onBeforeNavigate

browser.webNavigation.onBeforeNavigate.addListener(
  listener,                   // function
  filter                      // optional object
)
browser.webNavigation.onBeforeNavigate.removeListener(listener)
browser.webNavigation.onBeforeNavigate.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. Идентификатор процесса, в котором отображается эта вкладка (Это свойство не поддерживается в Firefox и устарело в Chrome).

frameId

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

parentFrameId

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

timeStamp

number. Время, когда браузер собирается начать навигацию, в миллисекундах с начала эпохи.

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

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

function logOnBefore(details) {
  console.log(`onBeforeNavigate to: ${details.url}`);
}

browser.webNavigation.onBeforeNavigate.addListener(logOnBefore, filter);