CKTIS / JavaScript
Error: основен обект за изключение
Error създава основния обект за грешка с незадължителни съобщение и причина, предназначен за хвърляне и свързване на неуспехи.
Версия: ECMAScript 1 onward; cause option from ECMAScript 2022; example target: Node.js 24.22.2
Синтаксис
Error(message?, options?); new Error(message?, options?)new Error(message?, options?) създава обект за грешка; извикването Error(...) без new има същия ефект. Ако message не е undefined, се преобразува в string и се записва като собствено неизброимо свойство message. Наследеното свойство name по подразбиране е "Error".
Ако options е обект със свойство cause, стойността му се копира без преобразуване в собствено неизброимо свойство cause. Така първоначалното изключение се запазва при добавяне на контекст. Преобразуването на съобщението или getter-ът cause може да хвърли. Error може да се наследява, а instanceof Error разпознава обикновени инстанции.
stack е полезно, но нестандартно разширение на host и форматът му не е преносим. За собствени категории използвайте подкласове, не анализ на message. Error съществува от ECMAScript 1; опцията cause е стандартна от ECMAScript 2022.
Примери
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);Резултат
Error Could not load config true (none) true