+ + +

+ + + Introduction + + + + + + + +
- + + + Overview + + + + + + + +
+ + +
+ + + Create apps + + + + + + + +
- + + + Create your first app + + + + + + + +
- + + + Platform support + + + + + + + +
- + + + Develop for platforms + + + + + + + +
  - + + + Android + + + + + + + +
  - + + + Blackberry 10 + + + + + + + +
  - + + + iOS + + + + + + + +
  - + + + Ubuntu + + + + + + + +
  - + + + Windows + + + + + + + +
  - + + + WP8 + + + + + + + +
  + + +
- + + + Manage versions and platforms + + + + + + + +
- + + + Use icons + + + + + + + +
- + + + Store data + + + + + + + +
- + + + Manage privacy + + + + + + + +
- + + + Manage security + + + + + + + +
- + + + Whitelisting + + + + + + + +
+ + +
+ + + Create plugins + + + + + + + +
- + + + Create a plugin + + + + + + + +
- + + + Develop for platforms + + + + + + + +
  - + + + Android + + + + + + + +
  - + + + Blackberry 10 + + + + + + + +
  - + + + iOS + + + + + + + +
  - + + + Windows + + + + + + + +
  - + + + WP8 + + + + + + + +
  + + +
- + + + Use Plugman + + + + + + + +
+ + +
+ + + Advanced Topics + + + + + + + +
- + + + Embed Cordova in native apps + + + + + + + +
- + + + Next Steps + + + + + + + +
+ + +
+ + + Reference + + + + + + + +
- + + + Config.xml + + + + + + + +
- + + + Events + + + + + + + +
- + + + CLI + + + + + + + +
- + + + Hooks + + + + + + + +
- + + + Plugin.xml + + + + + + + +
- + + + Plugin APIs + + + + + + + +
  - + + + Battery Status + + + + + + + +
  - + + + Camera + + + + + + + +
  - + + + Console + + + + + + + +
  - + + + Contacts + + + + + + + +
  - + + + Device + + + + + + + +
  - + + + Device Motion + + + + + + + +
  - + + + Device Orientation + + + + + + + +
  - + + + Dialogs + + + + + + + +
  - + + + File + + + + + + + +
  - + + + File Transfer + + + + + + + +
  - + + + Geolocation + + + + + + + +
  - + + + Globalization + + + + + + + +
  - + + + Inappbrowser + + + + + + + +
  - + + + Media + + + + + + + +
  - + + + Media Capture + + + + + + + +
  - + + + Network Information + + + + + + + +
  - + + + Splashscreen + + + + + + + +
  - + + + Vibration + + + + + + + +
  - + + + Statusbar + + + + + + + +
  - + + + Whitelist + + + + + + + +
  - + + + Legacy Whitelist + + + + + + + +
  + + +
+ + +

+ +

+ + +

+ +

+ + + Edit + + + +

+ + + + +

+ + + +

+ + + + + + + + + + + + + + +

+ + This version of the documentation is under development! + + Click here for the latest released version. + +

+ + + + +

+ + This documentation describes this plugin at version 1.0.2. + + Other versions are on GitHub. + +

+ + + +

+ + +

cordova-plugin-console

+ +

This plugin is meant to ensure that console.log() is as useful as it can be. +It adds additional function for iOS, Ubuntu, Windows Phone 8, and Windows. If +you are happy with how console.log() works for you, then you probably +don't need this plugin.

+ +

This plugin defines a global console object.

+ +

Although the object is in the global scope, features provided by this plugin +are not available until after the deviceready event.

document.addEventListener("deviceready", onDeviceReady, false);
+function onDeviceReady() {
+    console.log("console.log works well");
+}
+

Installation

cordova plugin add cordova-plugin-console
+

Android Quirks

+ +

On some platforms other than Android, console.log() will act on multiple +arguments, such as console.log("1", "2", "3"). However, Android will act only +on the first argument. Subsequent arguments to console.log() will be ignored. +This plugin is not the cause of that, it is a limitation of Android itself.

+ +

Supported Methods

+ +

The plugin support following methods of the console object:

+ +

console.log
console.error
console.exception
console.warn
console.info
console.debug
console.assert
console.dir
console.dirxml
console.time
console.timeEnd
console.table

+ +

Partially supported Methods

+ +

Methods of the console object which implemented, but behave different from browser implementation:

+ +

console.group
console.groupCollapsed

+ +

The grouping methods are just log name of the group and don't actually indicate grouping for later +calls to console object methods.

+ +

Not supported Methods

+ +

Methods of the console object which are implemented, but do nothing:

+ +

console.clear
console.trace
console.groupEnd
console.timeStamp
console.profile
console.profileEnd
console.count

+ +

Supported formatting

+ +

The following formatting options available:

+ +

Format chars:

+ +

%j - format arg as JSON
%o - format arg as JSON
%c - format arg as ''. No color formatting could be done.
%% - replace with '%'

+ +

any other char following % will format it's +arg via toString().

+ + +

Table of Contents

cordova-plugin-console

Installation

Android Quirks

Supported Methods

Partially supported Methods

Not supported Methods

Supported formatting