Safe, clear console logging for every browser
Log to the console — even legacy browsers without a console. Just pass any data to
log() and you'll see it printed clearly and well-structured in the console.
If the browser doesn't have a console, Firebug Lite will load. You can pass any variable type: strings, objects, arrays, functions, etc.
npm install consolelog
bower install consolelog
Or just download consolelog.js and reference it in your page with a
log() wherever you want to write to the console.
AMD with RequireJS
Consolelog.js is AMD-compliant and supports Common JS:
You can change some optional preferences by passing an object to
log.settings(). The defaults are shown below.
- Whether to append the actual line number to each log. Not supported by all browsers.
group(Boolean or object)
- Groups the arguments for each log together
collapsed: truewill collapse each group (in browsers that support collapsing)
label: "some string"sets the label or name for the groups
- Simply setting
group: trueis a shorthand way of selecting the defaults
This is an optional plugin to provide help information about the data that is being logged, especially in IE and older browsers. Just include consolelog.detailprint.js along with consolelog.js.
Firebug, WebKit's Developer Tools, and Opera's Dragonfly print useful, interactive items to the console. For example:
Some browsers that have a primitive console — one that does not expand arrays, does not link DOM elements to the source code, only prints objects as
[object Object] rather than listing their properties, etc.
Some cannot accept multiple arguments to a single
console.log call. This includes IE 7/8/9/10, iOS 5 and older, and Opera 11 and older, among others.
detailPrint companion plugin, special objects are presented in a more readable manner.
Console.log-wrapper is released under three licenses: MIT, BSD, and GPL.