2012-02-27 20:09:34 +01:00
|
|
|
# console
|
|
|
|
|
2012-03-03 00:14:03 +01:00
|
|
|
Stability: 4 - API Frozen
|
|
|
|
|
2012-02-27 20:09:34 +01:00
|
|
|
* {Object}
|
|
|
|
|
|
|
|
<!--type=global-->
|
2011-04-19 01:52:53 +02:00
|
|
|
|
2011-08-31 15:12:34 +02:00
|
|
|
For printing to stdout and stderr. Similar to the console object functions
|
|
|
|
provided by most web browsers, here the output is sent to stdout or stderr.
|
|
|
|
|
2012-04-21 19:55:14 +02:00
|
|
|
## console.log([data], [...])
|
2011-04-19 01:52:53 +02:00
|
|
|
|
|
|
|
Prints to stdout with newline. This function can take multiple arguments in a
|
|
|
|
`printf()`-like way. Example:
|
|
|
|
|
|
|
|
console.log('count: %d', count);
|
|
|
|
|
2011-11-26 03:26:11 +01:00
|
|
|
If formatting elements are not found in the first string then `util.inspect`
|
2012-06-06 21:05:18 +02:00
|
|
|
is used on each argument. See [util.format()][] for more information.
|
2011-04-19 01:52:53 +02:00
|
|
|
|
2012-04-21 19:55:14 +02:00
|
|
|
## console.info([data], [...])
|
2011-04-19 01:52:53 +02:00
|
|
|
|
|
|
|
Same as `console.log`.
|
|
|
|
|
2012-04-21 19:55:14 +02:00
|
|
|
## console.error([data], [...])
|
2011-04-19 01:52:53 +02:00
|
|
|
|
|
|
|
Same as `console.log` but prints to stderr.
|
|
|
|
|
2012-04-21 19:55:14 +02:00
|
|
|
## console.warn([data], [...])
|
|
|
|
|
|
|
|
Same as `console.error`.
|
|
|
|
|
2012-02-27 20:09:34 +01:00
|
|
|
## console.dir(obj)
|
2011-04-19 01:52:53 +02:00
|
|
|
|
2012-03-12 01:37:32 +01:00
|
|
|
Uses `util.inspect` on `obj` and prints resulting string to stdout.
|
2011-04-19 01:52:53 +02:00
|
|
|
|
2012-02-27 20:09:34 +01:00
|
|
|
## console.time(label)
|
2011-04-19 01:52:53 +02:00
|
|
|
|
|
|
|
Mark a time.
|
|
|
|
|
2012-02-27 20:09:34 +01:00
|
|
|
## console.timeEnd(label)
|
2011-04-19 01:52:53 +02:00
|
|
|
|
2012-04-21 19:55:14 +02:00
|
|
|
Finish timer, record output. Example:
|
2011-04-19 01:52:53 +02:00
|
|
|
|
|
|
|
console.time('100-elements');
|
2011-07-13 17:10:17 +02:00
|
|
|
for (var i = 0; i < 100; i++) {
|
2011-04-19 01:52:53 +02:00
|
|
|
;
|
|
|
|
}
|
|
|
|
console.timeEnd('100-elements');
|
|
|
|
|
2012-04-21 19:55:14 +02:00
|
|
|
## console.trace(label)
|
2011-04-19 01:52:53 +02:00
|
|
|
|
|
|
|
Print a stack trace to stderr of the current position.
|
|
|
|
|
2012-04-21 19:55:14 +02:00
|
|
|
## console.assert(expression, [message])
|
2011-04-19 01:52:53 +02:00
|
|
|
|
2012-06-06 21:05:18 +02:00
|
|
|
Same as [assert.ok()][] where if the `expression` evaluates as `false` throw an
|
|
|
|
AssertionError with `message`.
|
2011-04-19 01:52:53 +02:00
|
|
|
|
2012-06-06 21:05:18 +02:00
|
|
|
[assert.ok()]: assert.html#assert_assert_value_message_assert_ok_value_message
|
|
|
|
[util.format()]: util.html#util_util_format_format
|