KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

SyntaxError — syntaxfouten

SyntaxError duidt op een parseerfout in code of tekst die een bepaalde syntaxis moet volgen, zoals JSON. Leer het verschil tussen een fout die verhindert dat een script wordt uitgevoerd en een uitzondering die tijdens de uitvoering wordt gegenereerd.

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

new SyntaxError(message)
SyntaxError(message)
throw new SyntaxError(message)

SyntaxError is een ingebouwd ECMAScript-fouttype dat overerft van Error. Het signaleert een probleem bij het parsen en is geen afzonderlijke Web-API. Ongeldige JavaScript-code kan bijvoorbeeld vóór uitvoering worden afgewezen, terwijl JSON.parse() deze uitzondering genereert voor ongeldige JSON-tekst.

new SyntaxError(message) maakt een object aan, maar genereert het niet; gebruik daarvoor throw. De parameter message is optioneel. Ook de aanroep SyntaxError(message) zonder new maakt een foutobject aan. De standaardwaarde van name is "SyntaxError", en message beschrijft het probleem.

Een try...catch-blok kan geen syntaxfout opvangen die verhindert dat hetzelfde script wordt geparseerd: dat script begint dan helemaal niet met uitvoeren. Het kan wel een SyntaxError opvangen die tijdens de uitvoering wordt gegenereerd, bijvoorbeeld door JSON.parse() bij het parsen van tekst die als argument is meegegeven.

In het voorbeeld ontbreekt na "count": een JSON-waarde. De JavaScript-code zelf blijft geldig, zodat catch de uitzondering kan afhandelen. De controle instanceof SyntaxError herkent dit type binnen dezelfde realm; objecten uit een andere realm, zoals een ander venster, doorstaan de controle mogelijk niet. Vergelijk automatisch gegenereerde message-teksten niet, omdat de formulering per engine kan verschillen.

Voorbeelden

try {
  JSON.parse('{"count": }');
} catch (error) {
  if (!(error instanceof SyntaxError)) {
    throw error;
  }
  console.log(error.name);
}

Resultaat

SyntaxError

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