Browse Source

doc: improvements to console.markdown copy

Fix missing links. Fix styling of printf() - once #5073 lands,
link to man page will be auto-generated. Fix several typos.

PR-URL: https://github.com/nodejs/node/pull/5225
Reviewed-By: Roman Reiss <me@silverwind.io>
Reviewed-By: James M Snell <jasnell@gmail.com>
process-exit-stdio-flushing
Alexander Makarenko 9 years ago
committed by Roman Reiss
parent
commit
fb502ef081
  1. 33
      doc/api/console.markdown

33
doc/api/console.markdown

@ -48,7 +48,7 @@ myConsole.warn(`Danger ${name}! Danger!`);
```
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.
## 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
`process.stdout` and `process.stderr`. It is equivalent to calling:
[`process.stdout`][] and [`process.stderr`][]. It is equivalent to calling:
```js
new Console(process.stdout, process.stderr);
@ -99,7 +99,7 @@ new Console(process.stdout, process.stderr);
### console.assert(value[, message][, ...])
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.
```js
@ -111,17 +111,17 @@ console.assert(false, 'Whoops %s', 'didn\'t work');
### 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
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:
- `showHidden` - if `true` then the object's non-enumerable and symbol
properties will be shown too. Defaults to `false`.
- `depth` - tells `inspect` how many times to recurse while formatting the
object. This is useful for inspecting large complicated objects. Defaults to
`2`. To make it recurse indefinitely, pass `null`.
- `depth` - tells [`util.inspect()`][] how many times to recurse while
formatting the object. This is useful for inspecting large complicated objects.
Defaults to `2`. To make it recurse indefinitely, pass `null`.
- `colors` - if `true`, then the output will be styled with ANSI color codes.
Defaults to `false`. Colors are customizable; see
@ -129,9 +129,9 @@ Defaults to `false`. Colors are customizable; see
### console.error([data][, ...])
Prints to stderr with newline. Multiple arguments can be passed, with the first
used as the primary message and all additional used as substitution
values similar to `printf()` (the arguments are all passed to
Prints to `stderr` with newline. Multiple arguments can be passed, with the
first used as the primary message and all additional used as substitution
values similar to `printf(3)` (the arguments are all passed to
[`util.format()`][]).
```js
@ -152,9 +152,9 @@ The `console.info()` function is an alias for [`console.log()`][].
### console.log([data][, ...])
Prints to stdout with newline. Multiple arguments can be passed, with the first
used as the primary message and all additional used as substitution
values similar to `printf()` (the arguments are all passed to
Prints to `stdout` with newline. Multiple arguments can be passed, with the
first used as the primary message and all additional used as substitution
values similar to `printf(3)` (the arguments are all passed to
[`util.format()`][]).
```js
@ -192,7 +192,7 @@ console.timeEnd('100-elements');
### 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.
```js
@ -219,5 +219,8 @@ The `console.warn()` function is an alias for [`console.error()`][].
[`console.log()`]: #console_console_log_data
[`console.time()`]: #console_console_time_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.inspect()`]: util.html#util_util_inspect_object_options
[customizing `util.inspect()` colors]: util.html#util_customizing_util_inspect_colors

Loading…
Cancel
Save