Baseline Widely available
The cause
data property of an Error
instance indicates the specific original cause of the error.
It is used when catching and re-throwing an error with a more-specific or useful error message in order to still have access to the original error.
ValueThe value that was passed to the Error()
constructor in the options.cause
argument. It may not be present.
The value of cause
can be of any type. You should not make assumptions that the error you caught has an Error
as its cause
, in the same way that you cannot be sure the variable bound in the catch
statement is an Error
either. The "Providing structured data as the error cause" example below shows a case where a non-error is deliberately provided as the cause.
It is sometimes useful to catch an error and re-throw it with a new message. In this case you should pass the original error into the constructor for the new Error
, as shown.
try {
connectToDatabase();
} catch (err) {
throw new Error("Connecting to database failed.", { cause: err });
}
For a more detailed example see Error > Differentiate between similar errors.
Providing structured data as the error causeError messages written for human consumption may be inappropriate for machine parsing â since they're subject to rewording or punctuation changes that may break any existing parsing written to consume them. So when throwing an error from a function, as an alternative to a human-readable error message, you can instead provide the cause as structured data, for machine parsing.
function makeRSA(p, q) {
if (!Number.isInteger(p) || !Number.isInteger(q)) {
throw new Error("RSA key generation requires integer inputs.", {
cause: { code: "NonInteger", values: [p, q] },
});
}
if (!areCoprime(p, q)) {
throw new Error("RSA key generation requires two co-prime integers.", {
cause: { code: "NonCoprime", values: [p, q] },
});
}
// rsa algorithmâ¦
}
Specifications Browser compatibility See also
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4