CKTIS / JavaScript
Error: základný objekt výnimky
Error vytvorí základný chybový objekt s voliteľnou správou a príčinou určený na vyhadzovanie a reťazenie zlyhaní.
Verzia: ECMAScript 1 onward; cause option from ECMAScript 2022; example target: Node.js 24.22.2
Syntax
Error(message?, options?); new Error(message?, options?)new Error(message?, options?) vytvorí chybový objekt; volanie Error(...) bez new má rovnaký účinok. Ak message nie je undefined, prevedie sa na reťazec a uloží ako vlastná neenumerovateľná vlastnosť message. Zdedená vlastnosť name má predvolenú hodnotu "Error".
Ak je options objekt s vlastnosťou cause, jej hodnota sa bez prevodu skopíruje do vlastnej neenumerovateľnej vlastnosti cause. Tým zostane pôvodná výnimka pri doplnení kontextu zachovaná. Prevod správy alebo getter cause môže vyhodiť. Error možno dediť a instanceof Error rozpozná bežné inštancie.
stack je užitočné, ale neštandardné rozšírenie hostiteľa a jeho formát nie je prenosný. Pre vlastné kategórie používajte podtriedy, nie parsovanie message. Error existuje od ECMAScript 1; voľba cause je štandardná od ECMAScript 2022.
Prí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ýsledok
Error Could not load config true (none) true