OpenLayers. Console

The OpenLayers.Console namespace is used for debugging and error logging.  If the Firebug Lite (../Firebug/firebug.js) is included before this script, calls to OpenLayers.Console methods will get redirected to window.console.  This makes use of the Firebug extension where available and allows for cross-browser debugging Firebug style.

Note

Note that behavior will differ with the Firebug extention and Firebug Lite.  Most notably, the Firebug Lite console does not currently allow for hyperlinks to code or for clicking on object to explore their properties.

Summary
The OpenLayers.Console namespace is used for debugging and error logging.
Log an object in the console.
Writes a message to the console, including a hyperlink to the line where it was called.
Writes a message to the console with the visual “info” icon and color coding and a hyperlink to the line where it was called.
Writes a message to the console with the visual “warning” icon and color coding and a hyperlink to the line where it was called.
Writes a message to the console with the visual “error” icon and color coding and a hyperlink to the line where it was called.
Tests that an expression is true.
Prints an interactive listing of all properties of the object.
Prints the XML source tree of an HTML or XML element.
Prints an interactive stack trace of JavaScript execution at the point where it is called.
Writes a message to the console and opens a nested block to indent all future messages sent to the console.
Closes the most recently opened block created by a call to OpenLayers.Console.group
Creates a new timer under the given name.

Functions

log

log: function()

Log an object in the console.  The Firebug Lite console logs string representation of objects.  Given multiple arguments, they will be cast to strings and logged with a space delimiter.  If the first argument is a string with printf-like formatting, subsequent arguments will be used in string substitution.  Any additional arguments (beyond the number substituted in a format string) will be appended in a space- delimited line.

Examples

// Firebug Lite logs someObject.toString()
OpenLayers.Console.log(someObject);

// string substitution
OpenLayers.Console.log("%s jumped over %s", cow, moon);

Parameters

object{Object}

debug

debug: function()

Writes a message to the console, including a hyperlink to the line where it was called.

May be called with multiple arguments as with OpenLayers.Console.log().

Parameters

object{Object}

info

info: function()

Writes a message to the console with the visual “info” icon and color coding and a hyperlink to the line where it was called.

May be called with multiple arguments as with OpenLayers.Console.log().

Parameters

object{Object}

warn

warn: function()

Writes a message to the console with the visual “warning” icon and color coding and a hyperlink to the line where it was called.

May be called with multiple arguments as with OpenLayers.Console.log().

Parameters

object{Object}

error

error: function()

Writes a message to the console with the visual “error” icon and color coding and a hyperlink to the line where it was called.

May be called with multiple arguments as with OpenLayers.Console.log().

Parameters

object{Object}

assert

assert: function()

Tests that an expression is true.  If not, it will write a message to the console and throw an exception.

May be called with multiple arguments as with OpenLayers.Console.log().

Parameters

object{Object}

dir

dir: function()

Prints an interactive listing of all properties of the object.  This looks identical to the view that you would see in the DOM tab.

Parameters

object{Object}

dirxml

dirxml: function()

Prints the XML source tree of an HTML or XML element.  This looks identical to the view that you would see in the HTML tab.  You can click on any node to inspect it in the HTML tab.

Parameters

object{Object}

trace

trace: function()

Prints an interactive stack trace of JavaScript execution at the point where it is called.  The stack trace details the functions on the stack, as well as the values that were passed as arguments to each function.  You can click each function to take you to its source in the Script tab, and click each argument value to inspect it in the DOM or HTML tabs.

group

group: function()

Writes a message to the console and opens a nested block to indent all future messages sent to the console.  Call OpenLayers.Console.groupEnd() to close the block.

May be called with multiple arguments as with OpenLayers.Console.log().

Parameters

object{Object}

groupEnd

groupEnd: function()

Closes the most recently opened block created by a call to OpenLayers.Console.group

time

time: function()

Creates a new timer under the given name.  Call OpenLayers.Console.timeEnd(name) with the same name to stop the timer and print the time elapsed.

Parameters

name{String}

Constants

CLASS_NAME

log: function()
Log an object in the console.
debug: function()
Writes a message to the console, including a hyperlink to the line where it was called.
info: function()
Writes a message to the console with the visual “info” icon and color coding and a hyperlink to the line where it was called.
warn: function()
Writes a message to the console with the visual “warning” icon and color coding and a hyperlink to the line where it was called.
error: function()
Writes a message to the console with the visual “error” icon and color coding and a hyperlink to the line where it was called.
assert: function()
Tests that an expression is true.
dir: function()
Prints an interactive listing of all properties of the object.
dirxml: function()
Prints the XML source tree of an HTML or XML element.
trace: function()
Prints an interactive stack trace of JavaScript execution at the point where it is called.
group: function()
Writes a message to the console and opens a nested block to indent all future messages sent to the console.
groupEnd: function()
Closes the most recently opened block created by a call to OpenLayers.Console.group
time: function()
Creates a new timer under the given name.