webRequest.BlockingResponse

此类型的值为对象。它们包含以下属性

authCredentials 可选

object. 如果设置，则使用给定的凭据进行请求。你只能在 onAuthRequired 中设置此属性。authCredentials 属性是一个具有以下属性的对象

用户名

string. 要提供的用户名。

密码

string. 要提供的密码。

cancel 可选

boolean. 如果为 true，则取消请求。你只能在 onBeforeRequest、onBeforeSendHeaders、onHeadersReceived 和 onAuthRequired 中设置此属性。

redirectUrl 可选

string. 这是一个 URL，如果设置，则将原始请求重定向到该 URL。你只能在 onBeforeRequest 或 onHeadersReceived 中设置此属性。

允许重定向到非 HTTP 方案，例如 data:，但目前不支持 (Firefox 错误 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) 请求。如果任何扩展在 onBeforeRequest 中返回 redirectUrl，则 upgradeToSecure 将被忽略该请求。你只能在 onBeforeRequest 中设置此属性。