webNavigation.onReferenceFragmentUpdated

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

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

addListener(callback)

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

removeListener(listener)

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

hasListener(listener)

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

callback

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

details

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

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

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

tabId

integer. Идентификатор вкладки, в которой будет происходить навигация.

url

string. URL, на который данный фрейм будет перенаправлен.

processId

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

frameId

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

timeStamp

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

transitionType

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

transitionQualifiers

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

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

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

function logOnReferenceFragmentUpdated(details) {
  console.log(`onReferenceFragmentUpdated: ${details.url}`);
  console.log(`Transition type: ${details.transitionType}`);
  console.log(`Transition qualifiers: ${details.transitionQualifiers}`);
}

browser.webNavigation.onReferenceFragmentUpdated.addListener(logOnReferenceFragmentUpdated, filter);