1berry/nodejs
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

doc,errors: add extends to derived classes

Browse Source 
PR-URL: https://github.com/nodejs/node/pull/29303
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
This commit is contained in:
Kamat, Trivikram 2019-08-24 18:35:50 -07:00
parent 33ae95c58d
commit 5c9209bc4d
3 changed files with 34 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
doc/api/assert.md
View File

@ -10,8 +10,10 @@ lenient legacy mode.
## Class: assert.AssertionError
A subclass of `Error` that indicates the failure of an assertion. All errors
thrown by the `assert` module will be instances of the `AssertionError` class.
* Extends: {errors.Error}
Indicates the failure of an assertion. All errors thrown by the `assert` module
will be instances of the `AssertionError` class.
### new assert.AssertionError(options)
<!-- YAML

45
doc/api/errors.md
View File

@ -180,7 +180,7 @@ cases. If [domains][] are enabled, or a handler has been registered with
<!--type=class-->
A generic JavaScript `Error` object that does not denote any specific
A generic JavaScript {Error} object that does not denote any specific
circumstance of why the error occurred. `Error` objects capture a "stack trace"
detailing the point in the code at which the `Error` was instantiated, and may
provide a text description of the error.
@ -352,14 +352,18 @@ loop tick.
## Class: AssertionError
A subclass of `Error` that indicates the failure of an assertion. For details,
see [`Class: assert.AssertionError`][].
* Extends: {errors.Error}
Indicates the failure of an assertion. For details, see
[`Class: assert.AssertionError`][].
## Class: RangeError
A subclass of `Error` that indicates that a provided argument was not within the
set or range of acceptable values for a function; whether that is a numeric
range, or outside the set of options for a given function parameter.
* Extends: {errors.Error}
Indicates that a provided argument was not within the set or range of
acceptable values for a function; whether that is a numeric range, or
outside the set of options for a given function parameter.
```js
require('net').connect(-1);
@ -371,9 +375,11 @@ of argument validation.
## Class: ReferenceError
A subclass of `Error` that indicates that an attempt is being made to access a
variable that is not defined. Such errors commonly indicate typos in code, or
an otherwise broken program.
* Extends: {errors.Error}
Indicates that an attempt is being made to access a variable that is not
defined. Such errors commonly indicate typos in code, or an otherwise broken
program.
While client code may generate and propagate these errors, in practice, only V8
will do so.
@ -389,11 +395,12 @@ or its dependencies.
## Class: SyntaxError
A subclass of `Error` that indicates that a program is not valid JavaScript.
These errors may only be generated and propagated as a result of code
evaluation. Code evaluation may happen as a result of `eval`, `Function`,
`require`, or [vm][]. These errors are almost always indicative of a broken
program.
* Extends: {errors.Error}
Indicates that a program is not valid JavaScript. These errors may only be
generated and propagated as a result of code evaluation. Code evaluation may
happen as a result of `eval`, `Function`, `require`, or [vm][]. These errors
are almost always indicative of a broken program.
```js
try {
@ -408,6 +415,8 @@ they may only be caught by other contexts.
## Class: SystemError
* Extends: {errors.Error}
Node.js generates system errors when exceptions occur within its runtime
environment. These usually occur when an application violates an operating
system constraint. For example, a system error will occur if an application
@ -550,9 +559,11 @@ program. For a comprehensive list, see the [`errno`(3) man page][].
## Class: TypeError
A subclass of `Error` that indicates that a provided argument is not an
allowable type. For example, passing a function to a parameter which expects a
string would be considered a `TypeError`.
* Extends {errors.Error}
Indicates that a provided argument is not an allowable type. For example,
passing a function to a parameter which expects a string would be considered
a `TypeError`.
```js
require('url').parse(() => { });

2
tools/doc/type-parser.js
View File

@ -64,6 +64,8 @@ const customTypesMap = {
'Domain': 'domain.html#domain_class_domain',
'errors.Error': 'errors.html#errors_class_error',
'import.meta': 'esm.html#esm_import_meta',
'EventEmitter': 'events.html#events_class_eventemitter',