CKTIS / JavaScript
SyntaxError — errores de sintaxis
SyntaxError indica un fallo de análisis en código o texto que debe seguir una sintaxis determinada, como JSON. Aprende la diferencia entre un error que impide ejecutar un script y una excepción que se produce durante la ejecución.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
new SyntaxError(message)
SyntaxError(message)
throw new SyntaxError(message)SyntaxError es un tipo de error integrado de ECMAScript que hereda de Error. Indica un problema de análisis; no es una API web independiente. Por ejemplo, el código JavaScript no válido puede rechazarse antes de ejecutarse, mientras que JSON.parse() lanza esta excepción cuando el texto JSON no es válido.
new SyntaxError(message) crea un objeto, pero no lo lanza; para hacerlo, usa throw. El parámetro message es opcional. Llamar a SyntaxError(message) sin new también crea un objeto de error. El valor predeterminado de name es "SyntaxError", y message describe el problema.
Un bloque try...catch no puede capturar un error de sintaxis que impida analizar el mismo script: ese script nunca llega a empezar a ejecutarse. Sin embargo, sí puede capturar un SyntaxError lanzado durante la ejecución, como el que produce JSON.parse() al analizar texto proporcionado como argumento.
En el ejemplo, falta un valor JSON después de "count":. El código JavaScript en sí sigue siendo válido, por lo que catch puede gestionar la excepción. La comprobación instanceof SyntaxError reconoce este tipo dentro del mismo realm; los objetos de otro realm, como otra ventana, pueden no superar la comprobación. No compares las cadenas message generadas automáticamente, porque su redacción puede variar entre motores.
Ejemplos
try {
JSON.parse('{"count": }');
} catch (error) {
if (!(error instanceof SyntaxError)) {
throw error;
}
console.log(error.name);
}Resultado
SyntaxError
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.