webNavigation.onCreatedNavigationTarget

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

События имеют три функции:

addListener(callback)

Добавляет обработчик для этого события.

removeListener(listener)

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

hasListener(listener)

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

callback

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

details

object. Сведения о событии навигации. Дополнительную информацию см. в разделе details.

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

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

sourceFrameId

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

sourceProcessId

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

sourceTabId

integer. Идентификатор вкладки, из которой инициирована навигация. Например, если пользователь открывает ссылку в новой вкладке, это будет идентификатор вкладки, содержащей ссылку.

tabId

integer. Идентификатор новой вкладки.

timeStamp

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

url

string. URL, который будет загружен в новую вкладку.

windowId

number. Идентификатор окна, в котором создана новая вкладка.

Выводит целевой URL, идентификатор исходной вкладки и идентификатор исходного фрейма для onCreatedNavigationTarget, если имя хоста целевого объекта содержит "example.com" или начинается с "developer".

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

function logOnCreatedNavigationTarget(details) {
  console.log(`onCreatedNavigationTarget: ${details.url}`);
  console.log(details.sourceTabId);
  console.log(details.sourceFrameId);
}

browser.webNavigation.onCreatedNavigationTarget.addListener(logOnCreatedNavigationTarget, filter);