goog.log

Provided By	`goog.log`

No description available.

VIEW SOURCE

Functions

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

`logger`	`(goog.log.Logger\|null)`

`handler`	`function(goog.log.LogRecord): ?`
	Handler function to add.

VIEW SOURCE

Logs a message at the goog.log.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

`logger`	`(goog.log.Logger\|null)`

`msg`	`(string\|function(): string)`
	The message to log.
`exception`	`*=`
	An exception associated with the message.

VIEW SOURCE

Logs a message at the goog.log.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

`logger`	`(goog.log.Logger\|null)`

`msg`	`(string\|function(): string)`
	The message to log.
`exception`	`*=`
	An exception associated with the message.

VIEW SOURCE

Gets a list of all loggers.

Parameters

None.

Returns

Array<goog.log.Logger>

VIEW SOURCE

Returns the effective level of the logger based on its ancestors' levels.

Parameters

`logger`	`(goog.log.Logger\|null)`

Returns

goog.log.Level

The level.

VIEW SOURCE

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 goog.log.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.

Parameters

`logger`	`(goog.log.Logger\|null)`

Returns

(goog.log.Level|null)

The level.

VIEW SOURCE

Creates a log record. If the logger is currently enabled for the given message level then the given message is forwarded to all the registered output Handler objects. TODO(user): Delete this method from the public API.

Parameters

`logger`	`(goog.log.Logger\|null)`

`level`	`(goog.log.Level\|null)`
	One of the level identifiers.
`msg`	`string`
	The message to log.
`exception`	`*=`
	An exception associated with the message.

Returns

goog.log.LogRecord

VIEW SOURCE

Finds 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, it will be configured to send logging output to its parent's handlers.

Parameters

`name`	`string`
	A name for the logger. This should be a dot-separated name and should normally be based on the package name or class name of the subsystem, such as goog.net.BrowserChannel.
`level`	`(goog.log.Level\|null)=`
	If provided, override the default logging level with the provided level. This parameter is deprecated; prefer using goog.log.setLevel to set the logger's level instead. TODO(user): Delete this parameter.

Returns

(goog.log.Logger|null)

The named logger, or null if logging is disabled.

VIEW SOURCE

Returns the root logger.

Parameters

None.

Returns

(goog.log.Logger|null)

The root logger, or null if logging is disabled.

VIEW SOURCE

Logs a message at the goog.log.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

`logger`	`(goog.log.Logger\|null)`

`msg`	`(string\|function(): string)`
	The message to log.
`exception`	`*=`
	An exception associated with the message.

VIEW SOURCE

Checks if a message of the given level would actually be logged by this logger. This check is based on the goog.log.Loggers effective level, which may be inherited from its parent.

Parameters

`logger`	`(goog.log.Logger\|null)`

`level`	`(goog.log.Level\|null)`
	The level to check.

Returns

boolean

Whether the message would be logged.

VIEW SOURCE

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. TODO(user): The level parameter should be made required.

Parameters

`logger`	`(goog.log.Logger\|null)`

`level`	`(goog.log.Level\|null)`
	One of the level identifiers.
`msg`	`(string\|function(): string)`
	The message to log.
`exception`	`*=`
	An exception associated with the message.

VIEW SOURCE

Logs a goog.log.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. TODO(user): Delete this method from the public API.

Parameters

`logger`	`(goog.log.Logger\|null)`

`logRecord`	`goog.log.LogRecord`
	A log record to log.

VIEW SOURCE

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.

Parameters

`logger`	`(goog.log.Logger\|null)`

`handler`	`function(goog.log.LogRecord): ?`
	Handler function to remove.

Returns

boolean

Whether the handler was removed.

VIEW SOURCE

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 goog.log.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

`logger`	`(goog.log.Logger\|null)`

`level`	`(goog.log.Level\|null)`
	The new level.

VIEW SOURCE

Logs a message at the goog.log.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

`logger`	`(goog.log.Logger\|null)`

`msg`	`(string\|function(): string)`
	The message to log.
`exception`	`*=`
	An exception associated with the message.

VIEW SOURCE

Properties

A type that describes a function that handles logs.

VIEW SOURCE

A message value that can be handled by a goog.log.Logger.

Functions are treated like callbacks, but are only called when the event's log level is enabled. This is useful for logging messages that are expensive to construct.

VIEW SOURCE

No information.

VIEW SOURCE

Compiler Constants

Whether logging is enabled.

VIEW SOURCE

Interfaces

Logger

goog.log

Functions

addHandler( `logger`, `handler` ) `→` `void`

error( `logger`, `msg`, `exception` ) `→` `void`

fine( `logger`, `msg`, `exception` ) `→` `void`

getAllLoggers() `→` `Array<goog.log.Logger>`

getEffectiveLevel( `logger` ) `→` `goog.log.Level`

getLevel( `logger` ) `→` `(goog.log.Level|null)`

getLogRecord( `logger`, `level`, `msg`, `exception` ) `→` `goog.log.LogRecord`

getLogger( `name`, `level` ) `→` `(goog.log.Logger|null)`

getRootLogger() `→` `(goog.log.Logger|null)`

info( `logger`, `msg`, `exception` ) `→` `void`

isLoggable( `logger`, `level` ) `→` `boolean`

log( `logger`, `level`, `msg`, `exception` ) `→` `void`

publishLogRecord( `logger`, `logRecord` ) `→` `void`

removeHandler( `logger`, `handler` ) `→` `boolean`

setLevel( `logger`, `level` ) `→` `void`

warning( `logger`, `msg`, `exception` ) `→` `void`

Properties

LogRecordHandler `→` `function(goog.log.LogRecord): ?`

Loggable `→` `(string|function(): string)`

ROOT_LOGGER_NAME `→` `string`

Compiler Constants

goog.log.ENABLED `→` `boolean`

Interfaces

Classes

goog.log

Functions

addHandler( logger, handler ) → void

error( logger, msg, exception ) → void

fine( logger, msg, exception ) → void

getAllLoggers() → Array<goog.log.Logger>

getEffectiveLevel( logger ) → goog.log.Level

getLevel( logger ) → (goog.log.Level|null)

getLogRecord( logger, level, msg, exception ) → goog.log.LogRecord

getLogger( name, level ) → (goog.log.Logger|null)

getRootLogger() → (goog.log.Logger|null)

info( logger, msg, exception ) → void

isLoggable( logger, level ) → boolean

log( logger, level, msg, exception ) → void

publishLogRecord( logger, logRecord ) → void

removeHandler( logger, handler ) → boolean

setLevel( logger, level ) → void

warning( logger, msg, exception ) → void

Properties

LogRecordHandler → function(goog.log.LogRecord): ?

Loggable → (string|function(): string)

ROOT_LOGGER_NAME → string

Compiler Constants

goog.log.ENABLED → boolean

Interfaces

Classes

addHandler( `logger`, `handler` ) `→` `void`

error( `logger`, `msg`, `exception` ) `→` `void`

fine( `logger`, `msg`, `exception` ) `→` `void`

getAllLoggers() `→` `Array<goog.log.Logger>`

getEffectiveLevel( `logger` ) `→` `goog.log.Level`

getLevel( `logger` ) `→` `(goog.log.Level|null)`

getLogRecord( `logger`, `level`, `msg`, `exception` ) `→` `goog.log.LogRecord`

getLogger( `name`, `level` ) `→` `(goog.log.Logger|null)`

getRootLogger() `→` `(goog.log.Logger|null)`

info( `logger`, `msg`, `exception` ) `→` `void`

isLoggable( `logger`, `level` ) `→` `boolean`

log( `logger`, `level`, `msg`, `exception` ) `→` `void`

publishLogRecord( `logger`, `logRecord` ) `→` `void`

removeHandler( `logger`, `handler` ) `→` `boolean`

setLevel( `logger`, `level` ) `→` `void`

warning( `logger`, `msg`, `exception` ) `→` `void`

LogRecordHandler `→` `function(goog.log.LogRecord): ?`

Loggable `→` `(string|function(): string)`

ROOT_LOGGER_NAME `→` `string`

goog.log.ENABLED `→` `boolean`