Components.utils.reportError

z Mozilla Developer Center, polskiego centrum programistów Mozilli.

Components.utils.reportError zgłasza obiekt Error JavaScriptu do konsoli błędów. Powinna być wykorzystywana w blokach obsługi wyjątków, które chcą zgłosić dany problem do konsoli.

Metoda ta musi być wywołana z jednym parametrem, którym zwykle jest obiekt przechwycony przez kod obsługi wyjątków. Jeśli parametrem nie jest obiekt Error, parametr konwertowany jest na ciąg znaków i zgłaszany jako nowy błąd. Oznacza to, że metodę Components.utils.reportError można używać do wysyłania do konsoli błędów wiadomości debugowania, w sposób podobny do tego, w jaki można korzystać z dump() do wypisywania wiadomości na konsolę natywną.

Do informacji dziennika należy jednak używać nsIConsoleService, jako że interfejs ten wysyła wiadomości o zwykłym priorytecie, w przeciwieństwie do reportError.

function myDump(aMessage) {
  var consoleService = Components.classes["@mozilla.org/consoleservice;1"]
                                 .getService(Components.interfaces.nsIConsoleService);
  consoleService.logStringMessage("Mój komponent: " + aMessage);
}

[edytuj] Przykłady

Zastosowanie w obsłudze wyjątków:

try {
  ten.kod.wyrzuca.wyjątek;
} catch(e) {
  Components.utils.reportError(e); // wyślij informację o błędzie do konsoli i kontynuuj wykonanie
}

Wypisywanie informacji debugowania w konsoli błędów:

Components.utils.reportError("init() called");