webRequest

При некоторых событиях вы можете изменять запрос. В частности, вы можете:

• отменить запрос в:
  • onBeforeRequest
  • onBeforeSendHeaders
  • onAuthRequired
• перенаправить запрос в:
  • onBeforeRequest
  • onHeadersReceived
• изменять заголовки запроса в:
  • onBeforeSendHeaders
• изменять заголовки ответа в:
  • onHeadersReceived
• предоставить учетные данные для аутентификации в:
  • onAuthRequired

Для этого нужно передать опцию со значением "blocking" в аргумент extraInfoSpec к событию addListener(). Это делает обработчик синхронным.

В обработчике вы можете вернуть объект BlockingResponse, который указывает на необходимые изменения, например, измененный заголовок запроса, который нужно отправить.

Когда обработчик зарегистрирован с опцией "blocking" и зарегистрирован во время запуска расширения, если во время запуска браузера происходит запрос, соответствующий обработчику, расширение запускается раньше. Это позволяет расширению наблюдать за запросом при запуске браузера. Если вы не предпримите этих шагов, запросы, выполненные при запуске, могут быть пропущены.

Браузер может выполнять спекулятивные подключения, когда он определяет, что запрос к URI может появиться вскоре. Такое подключение не предоставляет действительную информацию о вкладке, поэтому такие данные о запросе, как tabId, frameId, parentFrameId, и т.д. неточны. Эти подключения имеют webRequest.ResourceType типа speculative.

В обработчике onHeadersReceived вы можете получить доступ к свойствам TLS запроса, вызвав getSecurityInfo(). Для этого необходимо также передать "blocking" в аргумент extraInfoSpec к событию addListener().

Вы можете прочитать детали рукопожатия TLS, но не можете их изменить или переопределить решения браузера о доверии.

Чтобы изменить тела HTTP-ответов для запроса, вызовите webRequest.filterResponseData, передав ему идентификатор запроса. Это возвращает объект webRequest.StreamFilter, который вы можете использовать для проверки и изменения данных по мере их получения браузером.

Для этого вам должно быть предоставлено разрешение "webRequestBlocking" API, а также разрешение "webRequest" API и разрешение на хост для соответствующего хоста.

webRequest.BlockingResponse

Объект этого типа возвращается обработчиками событий, которые установили "blocking" в их аргументе extraInfoSpec. Установив определённые свойства в BlockingResponse, обработчик может изменить сетевые запросы.

webRequest.CertificateInfo

Объект, описывающий один сертификат X.509.

webRequest.HttpHeaders

Массив HTTP-заголовков. Каждый заголовок представлен объектом с двумя свойствами: name и либо value, либо binaryValue.

webRequest.RequestFilter

Объект, описывающий фильтры для применения к webRequest событиям.

webRequest.ResourceType

Представляет определенный вид ресурса, полученного в веб-запросе.

webRequest.SecurityInfo

Объект, описывающий свойства безопасности конкретного веб-запроса.

webRequest.StreamFilter

Объект, который можно использовать для мониторинга и изменения HTTP-ответов по мере их получения.

webRequest.UploadData

Содержит данные, загруженные в запросе URL.

webRequest.MAX_HANDLER_BEHAVIOR_CHANGED_CALLS_PER_10_MINUTES

Максимальное количество вызовов handlerBehaviorChanged() в течение 10 минут.

webRequest.handlerBehaviorChanged()

Этот метод можно использовать для обеспечения правильного применения обработчиков событий, когда страницы находятся в кэше браузера в оперативной памяти.

webRequest.filterResponseData()

Возвращает объект webRequest.StreamFilter для заданного запроса.

webRequest.getSecurityInfo()

Получает подробную информацию о подключении TLS, связанном с заданным запросом.

webRequest.onBeforeRequest

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

webRequest.onBeforeSendHeaders

Вызывается перед отправкой любых данных HTTP, но после того, как доступны заголовки HTTP. Это хорошее место для прослушивания, если вы хотите изменить заголовки запроса HTTP.

webRequest.onSendHeaders

Вызывается непосредственно перед отправкой заголовков. Если ваше дополнение или какое-то другое дополнение изменили заголовки в onBeforeSendHeaders, вы увидите изменённую версию здесь.

webRequest.onHeadersReceived

Вызывается, когда были получены заголовки HTTP-ответа, связанные с запросом. Вы можете использовать это событие для изменения заголовков HTTP-ответа.

webRequest.onAuthRequired

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

webRequest.onResponseStarted

Вызывается, когда первый байт тела ответа получен. Для HTTP-запросов это означает, что доступны строка состояния и заголовки ответа.

webRequest.onBeforeRedirect

Вызывается, когда собирается произойти перенаправление, инициированное сервером.

webRequest.onCompleted

Вызывается, когда запрос завершён.

webRequest.onErrorOccurred

Вызывается, когда произошла ошибка.

• http-response
• root-cert-stats
• stored-credentials
• user-agent-rewriter