CKTIS / JavaScript
Error: podstawowy obiekt wyjątku
Error tworzy podstawowy obiekt błędu z opcjonalną wiadomością i przyczyną, przeznaczony do rzucania i łączenia awarii.
Wersja: ECMAScript 1 onward; cause option from ECMAScript 2022; example target: Node.js 24.22.2
Składnia
Error(message?, options?); new Error(message?, options?)new Error(message?, options?) tworzy obiekt błędu; wywołanie Error(...) bez new ma ten sam efekt. Jeśli message nie jest undefined, jest konwertowane do stringa i zapisane jako własna, niezliczalna właściwość message. Dziedziczona właściwość name ma domyślnie wartość "Error".
Jeśli options jest obiektem i ma właściwość cause, jej wartość jest kopiowana bez konwersji do własnej, niezliczalnej właściwości cause. Ułatwia to zachowanie pierwotnego wyjątku przy dodawaniu kontekstu. Konwersja wiadomości lub getter cause może rzucić. Error można rozszerzać klasą, a instanceof Error rozpoznaje zwykłe instancje.
stack jest użytecznym, lecz niestandardowym rozszerzeniem hosta i jego format nie jest przenośny. Do własnych kategorii używaj podklas, a nie parsowania tekstu message. Error istnieje od ECMAScript 1; opcja cause jest standardowa od ECMAScript 2022.
Przykłady
function loadConfig() {
try {
JSON.parse("{");
} catch (cause) {
throw new Error("Could not load config", {cause});
}
}
try {
loadConfig();
} catch (error) {
console.log(error.name, error.message);
console.log(error.cause instanceof SyntaxError);
console.log(Object.keys(error).join(",") || "(none)");
}
console.log(Error("plain") instanceof Error);Wynik
Error Could not load config true (none) true