proxy

Warning
不推荐使用 proxy.register() (en-US) 或者 proxy.unregister() (en-US) 方法使用 Proxy Auto-Configuration (PAC) file. 这个 API 将会在 Firefox 68 中废弃并且在 Firefox 71中删除.

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

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

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

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

如果你想用这个API你需要得到'proxy'的permission.并且,如果你想拦截一个请求,你同样也需要当前拦截请求的url的 host permission

Types

proxy.ProxyInfo (en-US)
Describes a proxy.
proxy.RequestDetails (en-US)

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

Properties

proxy.settings (en-US)
Get and set proxy settings.

Functions

proxy.register() (en-US)
Registers the given proxy script.
proxy.unregister() (en-US)
Unregisters the proxy script.

Events

proxy.onError (en-US)
Fired when the system encounters an error running the PAC script or the onRequest listener.
proxy.onRequest (en-US)
Fired when a web request is about to be made, giving the extension an opportunity to proxy it.

Example extensions

Browser compatibility

BCD tables only load in the browser