webNavigation.onErrorOccurred

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

У событий есть три функции:

addListener(listener)

addListener(listener, filter)

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

removeListener(listener)

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

hasListener(listener)

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

listener

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

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

details

object. Детали события навигации. details имеет следующие свойства:

tabId

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

url

string. URL, на который переходила данная рамка.

processId

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

frameId

integer. Рамка, в которой происходила навигация.

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

Положительное значение указывает, что навигация произошла во вложенном iframe.

Идентификаторы рамок уникальны для данной вкладки и процесса.

timeStamp

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

error

string. Код ошибки. Это внутренний код ошибки, и нет гарантии, что он останется неизменным или будет согласованным в разных браузерах.

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

object. Объект, содержащий единственное свойство url, которое является Array объектов events.UrlFilter.

Если вы включите этот параметр, событие будет срабатывать только для переходов по URL-адресам, которые соответствуют хотя бы одному UrlFilter в массиве.

Если вы опустите этот параметр, событие будет срабатывать для всех переходов.

Выводит целевые URL-адреса для onErrorOccurred, если целевой URL hostname содержит "example.com" или начинается с "developer".

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

function logOnErrorOccurred(details) {
  console.log(`onErrorOccurred: ${details.url}`);
  console.log(details.error);
}

browser.webNavigation.onErrorOccurred.addListener(logOnErrorOccurred, filter);