Components.utils.reportError reporte un objet d'erreur JavaScript vers la console d'erreurs JavaScript, et se termine. Vous pouvez l'utiliser dans des blocs de gestion d'exceptions pour « avaler » une exception, mais tout en conservant un report d'erreurs dans la console.
Il doit être appelé avec un seul paramètre qui est habituellement l'objet capturé par l'exception. S'il ne s'agit pas d'un objet d'erreur JavaScript, le paramètre est converti en chaîne de caractères et reporté en tant qu'erreur. Vous pouvez ainsi utiliser Components.utils.reportError pour afficher des messages de débogage dans la console d'erreurs JavaScript, comme dump() le fait dans un terminal.
Cependant pour ces reports, vous devriez utiliser nsIConsoleService qui affiche les messages avec une gravité normale, contrairement à reportError.
function myDump(aMessage) {
var consoleService = Components.classes["@mozilla.org/consoleservice;1"]
.getService(Components.interfaces.nsIConsoleService);
consoleService.logStringMessage("Mon composant : " + aMessage);
}
Exemples
Utilisation dans un gestionnaire d'exception :
try {
ceci.doit.lever.une.exception;
} catch(e) {
Components.utils.reportError(e); // Reporter l'erreur et continuer l'exécution
}
Affichage de messages de débogage dans la console d'erreurs JavaScript :
Components.utils.reportError("init() appelée");