@ -48,7 +48,7 @@ myConsole.warn(`Danger ${name}! Danger!`);
```
```
While the API for the `Console` class is designed fundamentally around the
While the API for the `Console` class is designed fundamentally around the
Web browser `console` object, the `Console` is Node.js is *not* intended to
Web browser `console` object, the `Console` in Node.js is *not* intended to
duplicate the browsers functionality exactly.
duplicate the browsers functionality exactly.
## Asynchronous vs Synchronous Consoles
## Asynchronous vs Synchronous Consoles
@ -90,7 +90,7 @@ logger.log('count: %d', count);
```
```
The global `console` is a special `Console` whose output is sent to
The global `console` is a special `Console` whose output is sent to
`process.stdout` and `process.stderr` . It is equivalent to calling:
[`process.stdout`][] and [`process.stderr`][] . It is equivalent to calling:
```js
```js
new Console(process.stdout, process.stderr);
new Console(process.stdout, process.stderr);
@ -99,7 +99,7 @@ new Console(process.stdout, process.stderr);
### console.assert(value[, message][, ...])
### console.assert(value[, message][, ...])
A simple assertion test that verifies whether `value` is truthy. If it is not,
A simple assertion test that verifies whether `value` is truthy. If it is not,
an `AssertionError` is throw. If provided, the error `message` is formatted
an `AssertionError` is thrown . If provided, the error `message` is formatted
using [`util.format()`][] and used as the error message.
using [`util.format()`][] and used as the error message.
```js
```js
@ -111,17 +111,17 @@ console.assert(false, 'Whoops %s', 'didn\'t work');
### console.dir(obj[, options])
### console.dir(obj[, options])
Uses [`util.inspect()`][] on `obj` and prints the resulting string to stdout.
Uses [`util.inspect()`][] on `obj` and prints the resulting string to ` stdout` .
This function bypasses any custom `inspect()` function defined on `obj` . An
This function bypasses any custom `inspect()` function defined on `obj` . An
optional `options` object may be passed that alters certain aspects of the
optional `options` object may be passed to alter certain aspects of the
formatted string:
formatted string:
- `showHidden` - if `true` then the object's non-enumerable and symbol
- `showHidden` - if `true` then the object's non-enumerable and symbol
properties will be shown too. Defaults to `false` .
properties will be shown too. Defaults to `false` .
- `depth` - tells `inspect` how many times to recurse while formatting th e
- `depth` - tells [`util.inspect()`][] how many times to recurse whil e
object. This is useful for inspecting large complicated objects. Defaults to
formatting the object. This is useful for inspecting large complicated objects.
`2` . To make it recurse indefinitely, pass `null` .
Defaults to `2` . To make it recurse indefinitely, pass `null` .
- `colors` - if `true` , then the output will be styled with ANSI color codes.
- `colors` - if `true` , then the output will be styled with ANSI color codes.
Defaults to `false` . Colors are customizable; see
Defaults to `false` . Colors are customizable; see
@ -129,9 +129,9 @@ Defaults to `false`. Colors are customizable; see
### console.error([data][, ...])
### console.error([data][, ...])
Prints to stderr with newline. Multiple arguments can be passed, with the first
Prints to ` stderr` with newline. Multiple arguments can be passed, with the
used as the primary message and all additional used as substitution
first used as the primary message and all additional used as substitution
values similar to `printf()` (the arguments are all passed to
values similar to `printf(3 )` (the arguments are all passed to
[`util.format()`][]).
[`util.format()`][]).
```js
```js
@ -144,7 +144,7 @@ console.error('error', code);
If formatting elements (e.g. `%d` ) are not found in the first string then
If formatting elements (e.g. `%d` ) are not found in the first string then
[`util.inspect()`][] is called on each argument and the resulting string
[`util.inspect()`][] is called on each argument and the resulting string
values are concatenated. See [`util.format()`][] for more information.
values are concatenated. See [`util.format()`][] for more information.
### console.info([data][, ...])
### console.info([data][, ...])
@ -152,9 +152,9 @@ The `console.info()` function is an alias for [`console.log()`][].
### console.log([data][, ...])
### console.log([data][, ...])
Prints to stdout with newline. Multiple arguments can be passed, with the first
Prints to ` stdout` with newline. Multiple arguments can be passed, with the
used as the primary message and all additional used as substitution
first used as the primary message and all additional used as substitution
values similar to `printf()` (the arguments are all passed to
values similar to `printf(3 )` (the arguments are all passed to
[`util.format()`][]).
[`util.format()`][]).
```js
```js
@ -167,7 +167,7 @@ console.log('count: ', count);
If formatting elements (e.g. `%d` ) are not found in the first string then
If formatting elements (e.g. `%d` ) are not found in the first string then
[`util.inspect()`][] is called on each argument and the resulting string
[`util.inspect()`][] is called on each argument and the resulting string
values are concatenated. See [`util.format()`][] for more information.
values are concatenated. See [`util.format()`][] for more information.
### console.time(label)
### console.time(label)
@ -192,7 +192,7 @@ console.timeEnd('100-elements');
### console.trace(message[, ...])
### console.trace(message[, ...])
Prints to stderr the string `'Trace :'` , followed by the [`util.format()`][]
Prints to ` stderr` the string `'Trace :'` , followed by the [`util.format()`][]
formatted message and stack trace to the current position in the code.
formatted message and stack trace to the current position in the code.
```js
```js
@ -219,5 +219,8 @@ The `console.warn()` function is an alias for [`console.error()`][].
[`console.log()`]: #console_console_log_data
[`console.log()`]: #console_console_log_data
[`console.time()`]: #console_console_time_label
[`console.time()`]: #console_console_time_label
[`console.timeEnd()`]: #console_console_timeend_label
[`console.timeEnd()`]: #console_console_timeend_label
[`process.stderr`]: process.html#process_process_stderr
[`process.stdout`]: process.html#process_process_stdout
[`util.format()`]: util.html#util_util_format_format
[`util.format()`]: util.html#util_util_format_format
[`util.inspect()`]: util.html#util_util_inspect_object_options
[`util.inspect()`]: util.html#util_util_inspect_object_options
[customizing `util.inspect()` colors]: util.html#util_customizing_util_inspect_colors