nsIProtocolProxyFilter

This interface is used to apply filters to the proxies selected for a given
URI. Use nsIProtocolProxyService::registerFilter to hook up instances of
this interface.

Methods

applyFilter(aProxyService, aURI, aProxy)

This method is called to apply proxy filter rules for the given URI
and proxy object (or list of proxy objects).

Parameters

aProxyService A reference to the Protocol Proxy Service. This is passed so that implementations may easily access methods such as newProxyInfo.
aURI The URI for which these proxy settings apply.
aProxy The proxy (or list of proxies) that would be used by default for the given URI. This may be null.

Returns

The proxy (or list of proxies) that should be used in place of aProxy. This can be just be aProxy if the filter chooses not to modify the proxy. It can also be null to indicate that a direct connection should be used. Use aProxyService.newProxyInfo to construct nsIProxyInfo objects.