CKTIS / JavaScript
Error: oggetto eccezione di base
Error crea l’oggetto errore di base con messaggio e causa facoltativi, destinato a lanciare e concatenare fallimenti.
Versione: ECMAScript 1 onward; cause option from ECMAScript 2022; example target: Node.js 24.22.2
Sintassi
Error(message?, options?); new Error(message?, options?)new Error(message?, options?) crea un oggetto errore; chiamare Error(...) senza new ha lo stesso effetto. Se message non è undefined, viene convertito in stringa e salvato come proprietà propria message non enumerabile. La proprietà ereditata name vale "Error" per impostazione predefinita.
Se options è un oggetto con proprietà cause, il valore viene copiato senza conversione in una proprietà propria cause non enumerabile. Così si conserva l’eccezione originale aggiungendo contesto. La conversione del messaggio o il getter cause può generare. Error può essere esteso e instanceof Error riconosce le istanze normali.
stack è un’utile estensione host non standard e il formato non è portabile. Per categorie personalizzate usa sottoclassi, non il parsing di message. Error esiste da ECMAScript 1; l’opzione cause è standard da ECMAScript 2022.
Esempi
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);Risultato
Error Could not load config true (none) true