proxy

Use the proxy API to proxy web requests. You can use the proxy.onRequest event listener to intercept web requests, and return an object that describes whether and how to proxy them.

使用proxy API来代理web请求。你可以使用proxy.onRequest事件监听器来拦截web请求，并且返回一个可以描述是否代理并且怎样代理它们的对象。

The advantage of the proxy.onRequest approach is that the code that implements your proxy policy runs in your extension's background script, so it gets full access to the WebExtension APIs available to your extension (including, for example, access to your extension's storage and networking APIs like dns).

proxy.onRequest的好处在于，用于实现你拦截策略的代码在你的扩展的后台脚本运行，所以，它可以让WebExtension APIs能够完全的访问你的扩展(举例来说，可以访问你扩展的storage和像dns等类似的网络api)

Apart from this API, extensions can also use the browserSettings.proxyConfig property to configure global proxy settings.

除了这个api，扩展也能够使用browserSettings.proxyConfig属性来重新编辑你全局的proxy设置

Google Chrome provides an extension API also called "proxy" which is functionally similar to this API, in that extensions can use it to implement a proxying policy. However, the design of the Chrome API is completely different to this API. Because this API is incompatible with the Chrome proxy API, this API is only available through the browser namespace.

Chrome浏览器提供了一个叫做'proxy'的api扩展，它的功能跟这个api类似，在chrome的api中也可以用来实现一个拦截策略。然而，Chrome 的API的设计跟这个API设计完全不同。因为这个API跟谷歌的proxy的API完全不同, 这个API只能通过浏览器的命名空间访问

To use this API you need to have the "proxy" permission. Also, where you want to intercept requests, you also need host permission for the URLs of intercepted requests.

如果你想用这个API你需要得到'proxy'的允许.并且，如果你想拦截一个请求，你同样也需要当前拦截请求的url的主机的允许。

Types

proxy.ProxyInfo

Describes a proxy.

proxy.RequestDetails

Contains information about a web request that the browser is about to make.

Properties

proxy.settings

Get and set proxy settings.

Functions

proxy.register()

Registers the given proxy script.

proxy.unregister()

Unregisters the proxy script.

Events

proxy.onError

Fired when the system encounters an error running the PAC script or the onRequest listener.

proxy.onRequest

Fired when a web request is about to be made, giving the extension an opportunity to proxy it.

Example extensions

• proxy-blocker

Browser compatibility