proxy.onError

Fired when there is an error evaluating the PAC file or the onRequest listener.

Syntax

browser.proxy.onError.addListener(listener)
browser.proxy.onError.removeListener(listener)
browser.proxy.onError.hasListener(listener)

Events have three functions:

addListener(listener)
Adds a listener to this event.
removeListener(listener)
Stop listening to this event. The listener argument is the listener to remove.
hasListener(listener)
Check whether listener is registered for this event. Returns true if it is listening, false otherwise.

addListener syntax

Parameters

callback

Function that will be called when this event occurs. The function will be passed the following arguments:

newState
Object. An Error object representing the error.

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxOperaFirefox for Android
Basic supportChrome No support NoEdge No support NoFirefox Full support 60
Full support 60
Full support 55
Alternate Name
Alternate Name Uses the non-standard name: onProxyError
Opera No support NoFirefox Android Full support 60
Full support 60
Full support 55
Alternate Name
Alternate Name Uses the non-standard name: onProxyError

Legend

Full support  
Full support
No support  
No support
Uses a non-standard name.
Uses a non-standard name.

Examples

This PAC script will fail, because window is not defined in the PAC script environment:

//pac.js

window.alert("This won't work");

The background script can use onProxyError to listen for errors like this:

// background.js

 // Log any errors from the proxy script
 browser.proxy.onError.addListener(error => {
   console.error(`Proxy error: ${error.message}`);
 });

In the console you'll see something like:

Proxy error: window is not defined

Document Tags and Contributors

Contributors to this page: wbamberg, hellosct1
Last updated by: wbamberg,