CKTIS / JavaScript
Error: základní objekt výjimky
Error vytvoří základní chybový objekt s volitelnou zprávou a příčinou určený k vyhazování a řetězení selhání.
Verze: ECMAScript 1 onward; cause option from ECMAScript 2022; example target: Node.js 24.22.2
Syntaxe
Error(message?, options?); new Error(message?, options?)new Error(message?, options?) vytvoří chybový objekt; volání Error(...) bez new má stejný účinek. Není-li message undefined, převede se na řetězec a uloží jako vlastní neenumerovatelná vlastnost message. Zděděná vlastnost name má výchozí hodnotu "Error".
Je-li options objekt s vlastností cause, její hodnota se bez převodu zkopíruje do vlastní neenumerovatelné vlastnosti cause. Tím zůstane původní výjimka při doplnění kontextu zachována. Převod zprávy nebo getter cause může vyhodit. Error lze dědit a instanceof Error rozpozná běžné instance.
stack je užitečné, ale nestandardní rozšíření hostitele a jeho formát není přenositelný. Pro vlastní kategorie používejte podtřídy, ne parsování message. Error existuje od ECMAScript 1; volba cause je standardní od ECMAScript 2022.
Příklady
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);Výsledek
Error Could not load config true (none) true