Browse Source

doc: add `added:` information for console

Information extracted from git history.

Ref: https://github.com/nodejs/node/issues/6578
PR-URL: https://github.com/nodejs/node/pull/6995
Reviewed-By: Anna Henningsen <anna@addaleax.net>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Julian Duque <julianduquej@gmail.com>
v7.x
Adrian Estrada 9 years ago
committed by Anna Henningsen
parent
commit
51b8a79bd4
No known key found for this signature in database GPG Key ID: D8B9F5AEAE84E4CF
  1. 27
      doc/api/console.md

27
doc/api/console.md

@ -97,6 +97,9 @@ new Console(process.stdout, process.stderr);
```
### console.assert(value[, message][, ...])
<!-- YAML
added: v0.1.101
-->
A simple assertion test that verifies whether `value` is truthy. If it is not,
an `AssertionError` is thrown. If provided, the error `message` is formatted
@ -150,6 +153,9 @@ console.log('this will also print');
```
### console.dir(obj[, options])
<!-- YAML
added: v0.1.101
-->
Uses [`util.inspect()`][] on `obj` and prints the resulting string to `stdout`.
This function bypasses any custom `inspect()` function defined on `obj`. An
@ -168,6 +174,9 @@ Defaults to `false`. Colors are customizable; see
[customizing `util.inspect()` colors][].
### console.error([data][, ...])
<!-- YAML
added: v0.1.100
-->
Prints to `stderr` with newline. Multiple arguments can be passed, with the
first used as the primary message and all additional used as substitution
@ -187,10 +196,16 @@ If formatting elements (e.g. `%d`) are not found in the first string then
values are concatenated. See [`util.format()`][] for more information.
### console.info([data][, ...])
<!-- YAML
added: v0.1.100
-->
The `console.info()` function is an alias for [`console.log()`][].
### console.log([data][, ...])
<!-- YAML
added: v0.1.100
-->
Prints to `stdout` with newline. Multiple arguments can be passed, with the
first used as the primary message and all additional used as substitution
@ -210,6 +225,9 @@ If formatting elements (e.g. `%d`) are not found in the first string then
values are concatenated. See [`util.format()`][] for more information.
### console.time(label)
<!-- YAML
added: v0.1.104
-->
Starts a timer that can be used to compute the duration of an operation. Timers
are identified by a unique `label`. Use the same `label` when you call
@ -217,6 +235,9 @@ are identified by a unique `label`. Use the same `label` when you call
milliseconds to stdout. Timer durations are accurate to the sub-millisecond.
### console.timeEnd(label)
<!-- YAML
added: v0.1.104
-->
Stops a timer that was previously started by calling [`console.time()`][] and
prints the result to stdout:
@ -236,6 +257,9 @@ leaking it. On older versions, the timer persisted. This allowed
functionality was unintended and is no longer supported.*
### console.trace(message[, ...])
<!-- YAML
added: v0.1.104
-->
Prints to `stderr` the string `'Trace :'`, followed by the [`util.format()`][]
formatted message and stack trace to the current position in the code.
@ -257,6 +281,9 @@ console.trace('Show me');
```
### console.warn([data][, ...])
<!-- YAML
added: v0.1.100
-->
The `console.warn()` function is an alias for [`console.error()`][].

Loading…
Cancel
Save