Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Error.message — il testo del messaggio di errore

La proprietà message di un’istanza Error contiene il testo del messaggio senza il nome dell’errore. Scopri la differenza tra error.message ed error.toString() e cosa succede quando il messaggio viene omesso.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

const error = new Error(message);
error.message

Error.message indica qui la proprietà message di un’istanza di errore, accessibile come error.message, non una proprietà statica del costruttore Error. Fa parte di ECMAScript, non di una Web API.

Quando si chiama new Error(message) con un argomento diverso da undefined, il costruttore applica l’operazione ToString. Solo se la conversione riesce, memorizza il risultato in una proprietà message propria, non enumerabile, scrivibile e configurabile. Ad esempio, new Error(Symbol()) solleva un’eccezione TypeError durante la conversione, quindi la chiamata non restituisce alcuna istanza. Se l’argomento viene omesso o vale undefined, il costruttore non crea una proprietà message propria; se il prototipo non è stato modificato, la lettura restituisce la proprietà ereditata Error.prototype.message, il cui valore iniziale è la stringa vuota "".

error.message contiene solo il messaggio. Al contrario, per un normale Error con un messaggio non vuoto, error.toString() combina il nome e il messaggio nella forma Error: Invalid input. Se il messaggio è vuoto, restituisce solo il nome Error.

Per avere esempi prevedibili, specifica un messaggio personalizzato, come qui sotto. Non basare la logica del programma sulla formulazione esatta dei messaggi generati dal motore: il testo può variare tra le implementazioni.

Esempi

const error = new Error("Invalid input");
console.log(error.message);
console.log(error.toString());
console.log(JSON.stringify(new Error().message));

Risultato

Invalid input
Error: Invalid input
""

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti