webNavigation

Добавляйте обработчики событий для различных этапов навигации. Навигация состоит из фрейма в браузере, переходящего от одного URL к другому, обычно (но не всегда) в ответ на действие пользователя, например, при нажатии на ссылку или вводе URL в строке адреса.

По сравнению с webRequest API: навигации обычно приводят к тому, что браузер выполняет веб-запросы, но API webRequest озабочен более низким уровнем представления из HTTP-слоя, в то время как API webNavigation больше озабочен представлением самого пользовательского интерфейса браузера.

Каждое событие соответствует определённому этапу навигации. Последовательность событий такова:

• Основной поток:
  • onBeforeNavigate
  • onCommitted
  • onDOMContentLoaded
  • onCompleted.
• Кроме того:
  • onCreatedNavigationTarget срабатывает до onBeforeNavigate, если браузеру потребовалось создать новую вкладку или окно для навигации (например, потому что пользователь открыл ссылку в новой вкладке).
  • onHistoryStateUpdated срабатывает, если страница использует API истории (2011) для обновления URL, отображаемого в адресной строке браузера.
  • onReferenceFragmentUpdated срабатывает, если изменяется идентификатор фрагмента фрагмента страницы.
  • onErrorOccurred может быть вызван в любой момент.

Каждая навигация — это переход по URL в определённом фрейме браузера. Фрейм браузера определяется идентификатором вкладки и идентификатором фрейма. Фрейм может быть контекстом верхнего уровня просмотра во вкладке или может быть вложенным контекстом просмотра, реализованным как iframe.

Вызов каждого события addListener() принимает необязательный параметр фильтра. Фильтр укажет один или несколько шаблонов URL, и событие затем будет активировано только для навигаций, в которых целевой URL соответствует одному из шаблонов.

Обработчик события onCommitted получает два дополнительных свойства: TransitionType, указывающее причину навигации (например, потому что пользователь нажал на ссылку или выбрал закладку), и TransitionQualifier, предоставляющее дополнительную информацию о навигации.

Для использования этого API вам необходимо иметь разрешение «webNavigation» разрешение.