Revision Content

Components.utils.reportError reports a JavaScript Error object to the Error Console, and returns. It is meant for use by extension developers who have exception handler blocks which want to "eat" an exception, but still want to report it to the console.

It must be called with one parameter, usually an object which was caught by an exception handler. If it is not a JavaScript error object, the parameter is converted to a string and reported as a new error. This means you can use Components.utils.reportError to report debugging messages to the Error Console, just like dump() can be used to print messages to the native console.

However you should use {{ interface("nsIConsoleService") }} for logging, as it logs the messages with normal severity, unlike reportError.

{{ Fx_minversion_note_start(3) }}The Error Console will not display chrome errors by default. To show them, set the preference 'javascript.options.showInConsole' to true, or use nsConsoleService instead to show a message.{{Fx_minversion_note_end() }}

{{ Fx_minversion_note(4, "The preference 'javascript.options.showInConsole' is set to true by default in this version.") }}

Revision Source

<p><code>Components.utils.reportError</code> reports a JavaScript Error object to the <a href="/en/Error_Console" title="en/Error_Console">Error Console</a>, and returns. It is meant for use by extension developers who have exception handler blocks which want to "eat" an exception, but still want to report it to the console.</p>
<p>It must be called with one parameter, usually an object which was caught by an exception handler. If it is not a JavaScript error object, the parameter is converted to a string and reported as a new error. This means you can use <code>Components.utils.reportError</code> to report debugging messages to the Error Console, just like <a href="/en/DOM/window.dump" title="en/DOM/window.dump">dump()</a> can be used to print messages to the native console.</p>
<p>However you should use {{ interface("nsIConsoleService") }} for logging, as it logs the messages with normal severity, unlike <code>reportError</code>.</p>
<pre class="eval">
function myDump(aMessage) {
var consoleService = Components.classes["@mozilla.org/consoleservice;1"]
.getService(Components.interfaces.nsIConsoleService);
consoleService.logStringMessage("My component: " + aMessage);
}
</pre>
<p>{{ Fx_minversion_note_start(3) }}The Error Console will not display chrome errors by default. To show them, set the preference 'javascript.options.showInConsole' to true, or use <a href="/en/Console_service" title="en/Console service">nsConsoleService </a>instead to show a message.{{Fx_minversion_note_end() }}</p>
<p>{{ Fx_minversion_note(4, "The preference 'javascript.options.showInConsole' is set to true by default in this version.") }}</p>
<h3 id="Examples" name="Examples">Examples</h3>
<p>Usage in an exception handler:</p>
<pre class="eval">
try {
this.could.raise.an.exception;
} catch(e) {
Components.utils.reportError(e); // report the error and continue execution
}
</pre>
<p>Sending debugging messages to the Error Console:</p>
<pre class="eval">
Components.utils.reportError("init() called");
</pre>
<p>{{ languages( { "fr": "fr/Components.utils.reportError", "ja": "ja/Components.utils.reportError", "pl": "pl/Components.utils.reportError" } ) }}</p>