Saltar al contenido
Herramientas y ecosistema

Lint y formato

Lección 3 de 69 min3 ejercicios

Muchos errores se pueden encontrar sin ejecutar el código: una variable que nunca se usa, un = donde iba ===, una línea que nunca se alcanza. Un linter los marca mientras escribes. Y un formateador se encarga de que todo el código tenga el mismo estilo, sin que nadie tenga que discutirlo.

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 . y prettier --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

Elige una respuesta en cada pregunta.

  1. ¿Qué diferencia hay entre un linter y un formateador?

  2. ¿Cómo se llama el formato de configuración actual de ESLint?

  3. ¿Por qué conviene un formateador automático en un equipo?

  4. ¿Qué es Biome?

Ordena la salida: Lo que encuentra el linter

Una función con tres problemas que no son errores de sintaxis. Ordena los avisos que mostraría ESLint.

// eslint.config.js usa js.configs.recommendedfunction sumar(a, b) {  const total = a + b;  if (a = 0) return b;  return a + b;  console.log("fin");} // Ejecutar: npx eslint sumar.js

Consola, de arriba abajo

  1. 6:3 error Unreachable code no-unreachable
  2. 3:9 error 'total' is assigned a value but never used no-unused-vars
  3. 4:7 error Expected a conditional expression and instead saw an assignment no-cond-assign

Detective: Una configuración del formato viejo

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.

domina-js · JavaScript en español, gratis y paso a paso.