KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Error: basisobject voor uitzonderingen

Error maakt het basisfoutobject met optioneel bericht en oorzaak, bedoeld om fouten te werpen en te koppelen.

Versie: 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?) maakt een foutobject; Error(...) zonder new heeft hetzelfde effect. Als message niet undefined is, wordt het naar een string omgezet en als eigen, niet-opsombare eigenschap message bewaard. De geërfde eigenschap name is standaard "Error".

Als options een object met eigenschap cause is, wordt de waarde zonder omzetting naar een eigen, niet-opsombare eigenschap cause gekopieerd. Zo blijft de oorspronkelijke uitzondering bij extra context bewaard. Berichtomzetting of de getter cause kan werpen. Error kan worden uitgebreid; instanceof Error herkent gewone instanties.

stack is een nuttige maar niet-standaard hostuitbreiding en het formaat is niet overdraagbaar. Gebruik subklassen voor eigen categorieën, niet het ontleden van message. Error bestaat sinds ECMAScript 1; cause is standaard sinds ECMAScript 2022.

Voorbeelden

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);

Resultaat

Error Could not load config
true
(none)
true

Bronnen