eslint · Compilación y tipos
El mensaje
Parsing error: Unexpected token
Qué significa
ESLint se detuvo mientras leía la sintaxis, antes de aplicar ninguna regla al archivo. Mucho más a menudo que un código realmente roto, esto significa que el analizador no conoce esa sintaxis: un archivo TypeScript leído por el analizador por defecto, JSX que nunca se activó, o decoradores y sintaxis muy nueva entregados a un analizador antiguo. Ejecutar npx eslint --print-config app.ts sobre ese archivo exacto imprime qué parser y qué parserOptions se aplican de verdad, así que empieza por ahí en vez de adivinar. TypeScript necesita @typescript-eslint/parser, y si el archivo no debería analizarse, listarlo en ignores es la respuesta correcta.
El arreglo
npx eslint --print-config app.ts- Lo imprime
- eslint
- Compilación y tipos
- 10
Los errores de compilación son una herramienta que se niega antes de que nada se ejecute, así que no rompen nada en el momento en que aparecen, pero plantean dos preguntas: ¿arreglarás el tipo o la ruta para que coincidan con la forma real, o empujarás esa única línea con un as any o un comentario de supresión? Y es aquí donde las cosas que solo son ciertas en tu máquina —mayúsculas, extensiones y variables de entorno— se muestran por primera vez.
Cómo leer un mensaje de error
- Lee desde la primera línea. Cuanto más abajo, más son las tripas de la herramienta; la causa suele estar arriba.
- Si hay un archivo y un número de línea, empieza ahí: no el marco superior de la pila, sino la línea más alta que nombre un archivo tuyo.
- Busca el mensaje literal, pero quita antes tus rutas y nombres de variables: eso es lo que impide que la búsqueda coincida.
- La misma condición se redacta distinto según la versión. Si los resultados no cuadran, añade el número de versión.
- Antes de pegar un arreglo, comprueba qué descarta. Algunos no se pueden deshacer.
Preguntas frecuentes
Q. ¿Qué significa «Parsing error: Unexpected token»?
ESLint se detuvo mientras leía la sintaxis, antes de aplicar ninguna regla al archivo. Mucho más a menudo que un código realmente roto, esto significa que el analizador no conoce esa sintaxis: un archivo TypeScript leído por el analizador por defecto, JSX que nunca se activó, o decoradores y sintaxis muy nueva entregados a un analizador antiguo. Ejecutar npx eslint --print-config app.ts sobre ese archivo exacto imprime qué parser y qué parserOptions se aplican de verdad, así que empieza por ahí en vez de adivinar. TypeScript necesita @typescript-eslint/parser, y si el archivo no debería analizarse, listarlo en ignores es la respuesta correcta.
Q. ¿Cómo se arregla?
npx eslint --print-config app.ts — antes de ejecutarlo, mira arriba qué descarta este comando.
Q. ¿Qué herramienta lo imprime?
eslint. Está en Compilación y tipos y el mensaje tiene 4 palabras.