Log.jsm

This module is still under development.
Until stabilized, expect frequent updates, including different interfaces and behavior in different versions of the platform.

Progress is tracked in Bugzilla using dependencies of bug 451283.

The Log.jsm JavaScript code module (formerly named log4moz.js) provides a log4j style API for logging log messages to various endpoints, such as the Browser Console or a file on disk. To use it, you first need to import the code module into your JavaScript scope:

Components.utils.import("resource://gre/modules/Log.jsm");

 

Basic usage

Components.utils.import("resource://gre/modules/Log.jsm");
// Get a logger, give it a name unique to this chunk of code.
// Use dots to create a hierarchy, this way you can later change
// the log level of sets of loggers under some common root
let log = Log.repository.getLogger("MyExtension.MyClass");
log.level = Log.Level.Debug;
// A console appender logs to the browser console.
log.addAppender(new Log.ConsoleAppender(new Log.BasicFormatter()));
// A dump appender logs to stdout.
log.addAppender(new Log.DumpAppender(new Log.BasicFormatter()));
// Log some messages
log.error("Oh noes!! Something bad happened!");
log.debug("Details about bad thing only useful during debugging", {someInfo: "nothing"});
log.warn("Here is an error", new Error("ouch"));

 

Logger levels

FATAL Severe errors that cause premature termination. Expect these to be immediately visible on a status console.
ERROR Other runtime errors or unexpected conditions. Expect these to be immediately visible on a status console.
WARN Use of deprecated APIs, poor use of API, 'almost' errors, other runtime situations that are undesirable or unexpected, but not necessarily "wrong". Expect these to be immediately visible on a status console.
INFO Interesting runtime events (startup/shutdown). Expect these to be immediately visible on a console, so be conservative and keep to a minimum.
CONFIG Information regarding important configuration options the system is using that affect how it runs.
DEBUG Detailed information on the flow through the system. Expect these to be written to logs only.
TRACE Most detailed information. Expect these to be written to logs only.

Class overview

Appender(); length: 1
Keys of prototype:
append();
doAppend();
level: 0
BasicFormatter(); length: 1
Keys of prototype:
format();
BoundedFileAppender(); length: 2
Keys of prototype:
doAppend();
reset();
ConsoleAppender(); length: 1
Keys of prototype:
doAppend();
DumpAppender(); length: 1
Keys of prototype:
doAppend();
FileAppender(); length: 2
Keys of prototype:
doAppend();
reset();
Formatter(); length: 0
Keys of prototype:
format();
LogMessage(); length: 4
Keys of prototype:
levelDesc
Logger(); length: 2
Keys of prototype:
addAppender();
level
logStructured();
name
parent
removeAppender();
updateAppenders();
And the methods mentioned below: Logger methods
LoggerRepository(); length: 0
Keys of prototype:
getLogger();
rootLogger
StorageStreamAppender(); length: 1
Keys of prototype:
doAppend();
getInputStream();
newOutputStream();
outputStream
reset();
StructuredFormatter(); length: 0
Keys of prototype:
format();

Method overview

enumerateInterfaces(); length: 0
enumerateProperties(); length: 2

Member fields

Variable Type Description
Level Object Contains the following fields:
Field Name Value
All 0
Config 30
Debug 20
Desc { 0: "ALL", 10: "TRACE", 20: "DEBUG", 30: "CONFIG", 40: "INFO", 50: "WARN", 60: "ERROR", 70: "FATAL" }
Error 30
Fatal 70
Info 40
Numbers { "ALL": 0, "TRACE": 10, "DEBUG": 20, "CONFIG": 30, "INFO": 40, "WARN": 50, "ERROR": 60, "FATAL": 70 }
Trace 10
Warn 50
repository LoggerRepository  

 

 

Logger methods

 

void fatal(string text, [optional] Object params);
void error(string text, [optional] Object params);
void warn(string text, [optional] Object params);
void info(string text, [optional] Object params);
void config(string text, [optional] Object params);
void debug(string text, [optional] Object params);
void trace(string text, [optional] Object params);

 

Document Tags and Contributors

 Last updated by: Mkmelin,