Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

SyntaxError — errori di sintassi

SyntaxError indica un errore di analisi in codice o testo che deve rispettare una sintassi specifica, come JSON. Scopri la differenza tra un errore che impedisce l’esecuzione di uno script e un’eccezione generata durante l’esecuzione.

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

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

SyntaxError è un tipo di errore ECMAScript integrato che eredita da Error. Segnala un problema di analisi; non è una Web API separata. Per esempio, il codice JavaScript non valido può essere rifiutato prima dell’esecuzione, mentre JSON.parse() genera questa eccezione per un testo JSON non valido.

new SyntaxError(message) crea un oggetto, ma non lo genera; per farlo, usa throw. Il parametro message è facoltativo. Anche la chiamata SyntaxError(message) senza new crea un oggetto di errore. Il valore predefinito di name è "SyntaxError" e message descrive il problema.

Un blocco try...catch non può intercettare un errore di sintassi che impedisce l’analisi dello stesso script: lo script non inizia mai a essere eseguito. Può però intercettare un SyntaxError generato durante l’esecuzione, per esempio da JSON.parse() mentre analizza il testo passato come argomento.

Nell’esempio manca un valore JSON dopo "count":. Il codice JavaScript in sé rimane valido, quindi catch può gestire l’eccezione. Il controllo instanceof SyntaxError riconosce questo tipo nello stesso realm; gli oggetti provenienti da un altro realm, per esempio un’altra finestra, potrebbero non superare il controllo. Non confrontare le stringhe message generate automaticamente, perché la formulazione può variare tra i motori.

Esempi

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

Risultato

SyntaxError

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