KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Error.message — de tekst van de foutmelding

De message-eigenschap van een Error-instantie bevat de tekst van de melding, zonder de naam van de fout. Lees wat het verschil is tussen error.message en error.toString() en wat er gebeurt als je de melding weglaat.

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

Syntax

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

Error.message verwijst hier naar de eigenschap message van een foutinstantie, die je leest als error.message, en niet naar een statische eigenschap van de Error-constructor. Deze eigenschap hoort bij ECMAScript, niet bij een Web-API.

Als je new Error(message) aanroept met een argument dat niet undefined is, past de constructor de operatie ToString toe. Alleen als de conversie slaagt, slaat de constructor het resultaat op in een eigen, niet-enumerable message-eigenschap die beschrijfbaar en configureerbaar is. Zo gooit new Error(Symbol()) tijdens de conversie een TypeError, waardoor de aanroep geen instantie teruggeeft. Als je het argument weglaat of het undefined is, maakt de constructor geen eigen message-eigenschap aan. Als het prototype ongewijzigd is, geeft het uitlezen de geërfde eigenschap Error.prototype.message terug, waarvan de beginwaarde de lege tekenreeks "" is.

error.message bevat alleen de melding. Bij een gewone Error met een niet-lege melding voegt error.toString() daarentegen de naam en melding samen tot Error: Invalid input. Als de melding leeg is, geeft de methode alleen de naam Error terug.

Geef voor voorspelbare voorbeelden zelf een melding op, zoals hieronder. Baseer je programmalogica niet op de exacte formulering van meldingen die door de engine worden gegenereerd: de tekst kan per implementatie verschillen.

Voorbeelden

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

Resultaat

Invalid input
Error: Invalid input
""

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen