ESLint
npm init @eslint/config@latest # asistente que crea la configuración
npx eslint . # revisa el proyecto
npx eslint . --fix # corrige lo que se puede corregir solo
La configuración es un archivo eslint.config.js (la flat config) que exporta un array de objetos. Cada objeto se aplica en orden, y los de después pueden cambiar a los de antes:
// eslint.config.js
import js from "@eslint/js";
import globals from "globals";
import { defineConfig } from "eslint/config";
export default defineConfig([
js.configs.recommended, // las reglas recomendadas
{
files: ["src/**/*.js"],
languageOptions: { globals: globals.browser }, // variables del navegador
rules: {
"no-unused-vars": "warn", // aviso en lugar de error
eqeqeq: "error", // obliga a usar === y !==
},
},
{ ignores: ["dist/"] },
]);
Cada regla puede estar en "off", "warn" o "error". Las reglas recomendadas atrapan errores de verdad: variables sin declarar, código inalcanzable, condiciones que siempre dan lo mismo, claves repetidas en un objeto. Para TypeScript está typescript-eslint, y cada framework tiene su plugin.
Prettier
Prettier no busca errores: reescribe el código con un estilo fijo (sangría, comillas, punto y coma, largo de las líneas). Tiene muy pocas opciones a propósito: la idea es dejar de discutir el estilo.
npm install -D prettier
npx prettier . --write # formatea todo
npx prettier . --check # solo comprueba (para integración continua)
// .prettierrc
{ "printWidth": 100, "singleQuote": false }
Si usas los dos, desactiva en ESLint las reglas de estilo (lo hace eslint-config-prettier): cada herramienta a lo suyo.
Biome
Biome es un linter y formateador en un solo programa, escrito en Rust y mucho más rápido. Una configuración, un comando:
npm install -D @biomejs/biome
npx biome init
npx biome check --write . # lint + formato, y corrige lo que puede
Tiene la mayoría de las reglas de ESLint y es compatible con el estilo de Prettier. Es una buena opción para proyectos nuevos; ESLint sigue siendo el estándar por su enorme cantidad de plugins.
Dónde ejecutarlos
- En el editor: con la extensión de ESLint (o de Biome) ves los errores mientras escribes, y con “formatear al guardar” no piensas más en el estilo.
- Antes de cada commit: herramientas como lint-staged con husky o lefthook revisan solo los archivos que cambiaron.
- En la integración continua:
eslint .yprettier --check .en cada pull request, para que nada se cuele.
Resumen
- Un linter (ESLint) encuentra errores y malas prácticas sin ejecutar el código.
- Un formateador (Prettier) unifica el estilo; no discutas más de comillas.
- ESLint usa la flat config: un array de objetos en
eslint.config.js. - Biome hace las dos cosas, muy rápido.
- Ejecútalos en el editor, antes de cada commit y en la integración continua.
¡A practicar!
Tu progreso se guarda en este navegador.
Autoevaluación: Errores que se ven antes de ejecutar
Resuelto
Elige una respuesta en cada pregunta.
¿Qué diferencia hay entre un linter y un formateador?
¿Cómo se llama el formato de configuración actual de ESLint?
¿Por qué conviene un formateador automático en un equipo?
¿Qué es Biome?
Ordena la salida: Lo que encuentra el linter
Resuelto
Una función con tres problemas que no son errores de sintaxis. Ordena los avisos que mostraría ESLint.
1// eslint.config.js usa js.configs.recommended2function sumar(a, b) {3 const total = a + b;4 if (a = 0) return b;5 return a + b;6 console.log("fin");7}8 9// Ejecutar: npx eslint sumar.jsConsola, de arriba abajo
- 6:3 error Unreachable code no-unreachable
- 3:9 error 'total' is assigned a value but never used no-unused-vars
- 4:7 error Expected a conditional expression and instead saw an assignment no-cond-assign
ESLint informa cada problema con su línea y columna, ordenados. total se calcula y nunca se usa; a = 0 asigna en lugar de comparar (y siempre da falso); y nada se ejecuta después de un return. Ninguno de los tres es un error de sintaxis: el código corre, pero mal.
Detective: Una configuración del formato viejo
Resuelto
Una configuración copiada de un tutorial antiguo hace fallar a ESLint. Encuentra la línea y elige el arreglo.
Consola
Oops! Something went wrong! :( ESLint: 9.28.0 A config object is using the "extends" key, which is not supported in flat config system. Instead of "extends", you can include config objects that you'd like to extend from directly in the flat config array.
Paso 1: toca la línea de código que causa el error.
Paso 2: ¿cómo lo arreglas?