Class: Logging

//use logger
 var Logger = mmir.require('mmirf/logger');
 var log = Logger.create('example');

 if(log.isVerbose()) log.debug('test');//will write the message to debug-console)
 log.error(new Error());//will write the error (including its stack) to error console)

 //example for setting up a logger in a requirejs-module:
 define(['mmirf/logger', 'module'], function(Logger, module){

   var logger = Logger.create(module);
   //this would create the same logger-object:
   //  Logger.create(module.id, module.config(module).logLevel);

   //use the logger instance...

   //create / retrieve the same logger
   var sameLogger = Logger.create(module.id);

 });

Members

_level

the (global) logging level 0: verbose 1: debug 2: info 3: warn 4: error 5: critical 6: disabled

Methods

create(loggerName, logLevel){Logger}

tools/logger.js, line 908

Creates a Logger instance. If a logger for loggerName already exists, the existing logger is returned (instead of creating a new one).

Name	Type	Description
loggerName	String | Object	optional If String: a name / ID for the logger that should be created / retrieved. If Object: an requirejs module object, i.e. should contain properties id (String) which will set the loggerName, and a property/function config (Function) that returns an object with property logLevel (i.e. config().logLevel should be valid). If omitted, the default logger will be returned.
logLevel	String	optional a name / ID for the logger that should be created / retrieved. If omitted, the default logger will be returned.

See:

• Logger
• Logger#setLevel

Returns:

Type	Description
Logger	the created (or retrieved) logger

debug()

tools/logger.js, line 1005

Print debug message with default logger.

See:

• Logger#debug

error()

tools/logger.js, line 1029

Print error with default logger.

See:

• Logger#error

getDefaultLogLevel(){Number}

tools/logger.js, line 981

Sets the default log-level.

See:

• setDefaultLogLevel
• Logger#getLevel

Returns:

Type	Description
Number	the log level: a number between 0 (verbose) and 6 (disabled)

info()

tools/logger.js, line 1013

Print information message with default logger.

See:

• Logger#info

log()

tools/logger.js, line 989

Print log output with default logger.

See:

• Logger#log

setDefaultLogLevel(theLevel)

tools/logger.js, line 963

Sets the default log-level. This setting is used by loggers, that do not have a specific log-level set.

Name	Type	Description
theLevel	String | Number	if NUMBER, the log level as a number between 0 (verbose) and 6 (disabled) if STRING, the logging level as a string (see getLevel)

See:

• getDefaultLogLevel
• Logger#getLevel

verbose()

tools/logger.js, line 997

Print verbose output with default logger.

See:

• Logger#verbose

warn()

tools/logger.js, line 1021

Print warning message with default logger.

See:

• Logger#warn