Welcome to mirror list, hosted at ThFree Co, Russian Federation.

github.com/nodejs/node.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMinwoo Jung <minwoo@nodesource.com>2019-03-29 06:12:48 +0300
committerBeth Griggs <Bethany.Griggs@uk.ibm.com>2019-04-10 17:30:27 +0300
commit316372c0f7cded21a1923971d7adbd22a3330828 (patch)
tree03b059b82319979155d38c1aa47b8c86f15d891b
parentaddc73af5c4e5f40a4986a1de54642df441415a1 (diff)
doc: remove old system_errors
Remove old errors_system_errors, any useful information in it moved into the SystemError class docs. Fixes: https://github.com/nodejs/node/issues/26861 PR-URL: https://github.com/nodejs/node/pull/27037 Reviewed-By: Sam Roberts <vieuxtech@gmail.com> Signed-off-by: Beth Griggs <Bethany.Griggs@uk.ibm.com>
-rw-r--r--doc/api/errors.md30
-rw-r--r--doc/api/os.md1
2 files changed, 10 insertions, 21 deletions
diff --git a/doc/api/errors.md b/doc/api/errors.md
index 986c8e7e7e8..4115d70115b 100644
--- a/doc/api/errors.md
+++ b/doc/api/errors.md
@@ -355,9 +355,6 @@ The number of frames captured by the stack trace is bounded by the smaller of
`Error.stackTraceLimit` or the number of available frames on the current event
loop tick.
-System-level errors are generated as augmented `Error` instances, which are
-detailed [here](#errors_system_errors).
-
## Class: AssertionError
A subclass of `Error` that indicates the failure of an assertion. For details,
@@ -442,20 +439,13 @@ Some exceptions are *unrecoverable* at the JavaScript layer. Such exceptions
will *always* cause the Node.js process to crash. Examples include `assert()`
checks or `abort()` calls in the C++ layer.
-## System Errors
+## Class: SystemError
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
attempts to read a file that does not exist.
-System errors are usually generated at the syscall level. For a comprehensive
-list, see the [`errno`(3) man page][].
-
-In Node.js, system errors are `Error` objects with extra properties.
-
-### Class: SystemError
-
* `address` {string} If present, the address to which a network connection
failed
* `code` {string} The string error code
@@ -468,27 +458,27 @@ In Node.js, system errors are `Error` objects with extra properties.
* `port` {number} If present, the network connection port that is not available
* `syscall` {string} The name of the system call that triggered the error
-#### error.address
+### error.address
* {string}
If present, `error.address` is a string describing the address to which a
network connection failed.
-#### error.code
+### error.code
* {string}
The `error.code` property is a string representing the error code.
-#### error.dest
+### error.dest
* {string}
If present, `error.dest` is the file path destination when reporting a file
system error.
-#### error.errno
+### error.errno
* {string|number}
@@ -498,31 +488,31 @@ negative value which corresponds to the error code defined in
(`deps/uv/include/uv/errno.h` in the Node.js source tree) for details. In case
of a string, it is the same as `error.code`.
-#### error.info
+### error.info
* {Object}
If present, `error.info` is an object with details about the error condition.
-#### error.message
+### error.message
* {string}
`error.message` is a system-provided human-readable description of the error.
-#### error.path
+### error.path
* {string}
If present, `error.path` is a string containing a relevant invalid pathname.
-#### error.port
+### error.port
* {number}
If present, `error.port` is the network connection port that is not available.
-#### error.syscall
+### error.syscall
* {string}
diff --git a/doc/api/os.md b/doc/api/os.md
index 0a71dff7f70..b41067111f1 100644
--- a/doc/api/os.md
+++ b/doc/api/os.md
@@ -1315,7 +1315,6 @@ The following process scheduling constants are exported by
</tr>
</table>
-[`SystemError`]: errors.html#errors_system_errors
[`process.arch`]: process.html#process_process_arch
[`process.platform`]: process.html#process_process_platform
[Android building]: https://github.com/nodejs/node/blob/master/BUILDING.md#androidandroid-based-devices-eg-firefox-os