proxy.onProxyError

Fired when there is an error evaluating the PAC file.

Syntax

browser.proxy.onProxyError.addListener(listener)
browser.proxy.onProxyError.removeListener(listener)
browser.proxy.onProxyError.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

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.onProxyError.addListener(error => {
   console.error(`Proxy error: ${error.message}`);
 });

In the console you'll see something like:

Proxy error: window is not defined

Example extensions

Acknowledgements

Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.

Document Tags and Contributors

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