Class goog.debug.Logger
code »The Logger is an object used for logging debug messages. Loggers are normally named, using a hierarchical dot-separated namespace. Logger names can be arbitrary strings, but they should normally be based on the package name or class name of the logged component, such as goog.net.BrowserChannel. The Logger object is loosely based on the java class java.util.logging.Logger. It supports different levels of filtering for different loggers. The logger object should never be instantiated by application code. It should always use the goog.debug.Logger.getLogger function.
Constructor
Parameters |
---|
|
Classes
|
Instance Methods
Adds a child to this logger. This is used for setting up the logger tree.
Parameters |
---|
|
code »addHandler ( handler )Adds a handler to the logger. This doesn't use the event system because
we want to be able to add logging to the event system.
Parameters |
---|
|
code »callPublish_ ( logRecord )Calls the handlers for publish.
Parameters |
---|
|
Logs a message at the Logger.Level.CONFIG level.
If the logger is currently enabled for the given message level then the
given message is forwarded to all the registered output Handler objects.
Parameters |
---|
|
code »doLogRecord_ ( logRecord )Logs a LogRecord.
Parameters |
---|
|
Logs a message at the Logger.Level.FINE level.
If the logger is currently enabled for the given message level then the
given message is forwarded to all the registered output Handler objects.
Parameters |
---|
|
Logs a message at the Logger.Level.FINER level.
If the logger is currently enabled for the given message level then the
given message is forwarded to all the registered output Handler objects.
Parameters |
---|
|
Logs a message at the Logger.Level.FINEST level.
If the logger is currently enabled for the given message level then the
given message is forwarded to all the registered output Handler objects.
Parameters |
---|
|
code »getChildren ( ) ⇒ !Object
Returns the children of this logger as a map of the child name to the logger.
!Object
Returns |
---|
|
Returns the effective level of the logger based on its ancestors' levels.
Returns |
---|
|
Gets the log level specifying which message levels will be logged by this
logger. Message levels lower than this value will be discarded.
The level value Level.OFF can be used to turn off logging. If the level
is null, it means that this node should inherit its level from its nearest
ancestor with a specific (non-null) level value.
Returns |
---|
|
code »getLogRecord ( level, msg, opt_exception, opt_fnStackContext ) ⇒ !goog.debug.LogRecord
Creates a new log record and adds the exception (if present) to it.
!goog.debug.LogRecord
Parameters |
---|
|
Returns |
|
Returns the parent of this logger.
Returns |
---|
|
Logs a message at the Logger.Level.INFO level.
If the logger is currently enabled for the given message level then the
given message is forwarded to all the registered output Handler objects.
Parameters |
---|
|
code »isLoggable ( level ) ⇒ boolean
Checks if a message of the given level would actually be logged by this
logger. This check is based on the Loggers effective level, which may be
inherited from its parent.
boolean
Parameters |
---|
|
Returns |
|
Logs a message. If the logger is currently enabled for the
given message level then the given message is forwarded to all the
registered output Handler objects.
Parameters |
---|
|
Logs a LogRecord. If the logger is currently enabled for the
given message level then the given message is forwarded to all the
registered output Handler objects.
Parameters |
---|
|
code »removeHandler ( handler ) ⇒ boolean
Removes a handler from the logger. This doesn't use the event system because
we want to be able to add logging to the event system.
boolean
Parameters |
---|
|
Returns |
|
Set the log level specifying which message levels will be logged by this
logger. Message levels lower than this value will be discarded.
The level value Level.OFF can be used to turn off logging. If the new level
is null, it means that this node should inherit its level from its nearest
ancestor with a specific (non-null) level value.
Parameters |
---|
|
code »setParent_ ( parent )Sets the parent of this logger. This is used for setting up the logger tree.
Parameters |
---|
|
Logs a message at the Logger.Level.SEVERE level.
If the logger is currently enabled for the given message level then the
given message is forwarded to all the registered output Handler objects.
Parameters |
---|
|
Logs a message at the Logger.Level.SHOUT level.
If the logger is currently enabled for the given message level then the
given message is forwarded to all the registered output Handler objects.
Parameters |
---|
|
Logs a message at the Logger.Level.WARNING level.
If the logger is currently enabled for the given message level then the
given message is forwarded to all the registered output Handler objects.
Parameters |
---|
|
Instance Properties
Level that this logger only filters above. Null indicates it should
inherit from the parent.
Parent Logger.
Static Functions
code »goog.debug.Logger.getLogger ( name ) ⇒ !goog.debug.Logger
Deprecated: use goog.log instead. http://go/goog-debug-logger-deprecatedFinds or creates a logger for a named subsystem. If a logger has already been
created with the given name it is returned. Otherwise a new logger is
created. If a new logger is created its log level will be configured based
on the LogManager configuration and it will configured to also send logging
output to its parent's handlers. It will be registered in the LogManager
global namespace.
!goog.debug.Logger
Parameters |
---|
|
Returns |
|
Logs a message to profiling tools, if available.
https://developers.google.com/web-toolkit/speedtracer/logging-api
http://msdn.microsoft.com/en-us/library/dd433074(VS.85).aspx
Parameters |
---|
|