webRequest.BlockingResponse

Значения этого типа являются объектами. Они содержат следующие свойства:

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

object. Если установлено, запрос выполняется с использованием предоставленных учетных данных. Вы можете установить это свойство только в onAuthRequired. Свойство authCredentials — это объект со следующими свойствами:

username

string. Имя пользователя для ввода.

password

string. Пароль для ввода.

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

boolean. Если true, запрос отменяется. Вы можете установить это свойство только в onBeforeRequest, onBeforeSendHeaders, onHeadersReceived и onAuthRequired.

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

string. Это URL-адрес, и если он задан, исходный запрос перенаправляется на этот URL. Вы можете установить это свойство только в onBeforeRequest или onHeadersReceived.

Перенаправления на схемы, отличные от HTTP, такие как data:, разрешены, но в настоящее время не поддерживаются (Firefox bug 707624). Перенаправления используют тот же метод запроса, что и исходный запрос, за исключением случаев, когда инициированы со стадии onHeadersReceived, в этом случае перенаправление использует метод GET.

Если расширение хочет перенаправить публичный (например, HTTPS) URL на страницу расширения (например, страницу расширения), в файле manifest.json расширения должен быть ключ web_accessible_resources, который перечисляет URL страницы расширения.

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

webRequest.HttpHeaders. Это объект HttpHeaders, массив, в котором каждый объект представляет заголовок. Если установлено, запрос выполняется с этими заголовками вместо исходных. Вы можете установить это свойство только в onBeforeSendHeaders.

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

webRequest.HttpHeaders. Это объект HttpHeaders, массив, в котором каждый объект представляет заголовок. Если установлено, предполагается, что сервер ответил этими заголовками ответа вместо исходных. Вы можете установить это свойство только в onHeadersReceived. Если несколько расширений пытаются установить один и тот же заголовок (например, Content-Security-Policy), только одно из изменений будет успешным.

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

boolean. Если установлено в значение true и исходный запрос является запросом HTTP, это предотвратит отправку исходного запроса и вместо этого выполнит безопасный (HTTPS) запрос. Если какое-либо расширение возвращает redirectUrl в onBeforeRequest, upgradeToSecure будет проигнорировано для этого запроса. Вы можете установить это свойство только в onBeforeRequest.