# ESLint

## Was es ist

ESLint ist ein quelloffenes Werkzeug zur statischen Analyse. Es liest
JavaScript-Quellcode, prüft ihn gegen einen konfigurierten Regelsatz und meldet
jede Stelle, die eine Regel verletzt. Auf Wunsch repariert es einfachere Fälle
selbst. Auf der Kommandozeile heißt der Befehl `eslint`; er wird über npm als
Entwicklungsabhängigkeit des geprüften Projekts installiert. Nicholas C. Zakas
begann das Projekt im Juni 2013. Es stellt sich weiterhin als konfigurierbarer
JavaScript-Linter vor.

Das geprüfte Programm wird dabei nie ausgeführt. Ein Parser verwandelt jede Datei in
einen abstrakten Syntaxbaum im ESTree-Format. Jede Regel ist ein kleines Modul,
das für bestimmte Knotentypen aufgerufen werden möchte: jede Funktion, jeden
Vergleich, jedes `await`. Die Regel untersucht den übergebenen Knoten und meldet
bei einem Problem eine Nachricht samt Position. Manche Regeln enthalten auch
eine Korrektur. Das Projekt akzeptiert solche Änderungen nur, wenn sie das
Problem beheben, ohne das Verhalten des Programms zu ändern. `eslint --fix`
wendet sie auf die Dateien an. Andere Regeln bieten stattdessen Vorschläge,
die das Verhalten ändern können und deshalb einzeln von einem Menschen im
Editor angewendet werden.

Fast alles um diesen Kern lässt sich austauschen. Plugins sind npm-Pakete, die
Regeln, gemeinsam nutzbare Konfigurationen, Prozessoren oder Unterstützung für andere
Sprachen ergänzen. Mit einem anderen Parser kann ESLint Syntax lesen, die der
Standardparser nicht versteht, etwa TypeScript. Prozessoren extrahieren
JavaScript aus anderen Dateien, beispielsweise aus Codeblöcken in einem
Markdown-Dokument. Formatter ändern die Ausgabe des Berichts. Zur eigenen
Philosophie erklärt das Projekt, dass jede Regel eigenständig ist, sich
abschalten lässt und unabhängig auf Warnung oder Fehler eingestellt werden kann.

All das wird in einer JavaScript-Datei im Projektstammverzeichnis konfiguriert,
üblicherweise `eslint.config.js` oder einer Variante mit `.mjs` oder `.cjs`.
Sie exportiert ein Array von Objekten. Jedes Objekt nennt die betroffenen Dateien
sowie deren Regeln, globale Variablen und Parseroptionen; spätere Objekte
überschreiben frühere. Dieser Aufbau heißt Flat Config und wurde mit ESLint
v9.0.0 am 5. April 2024 zum Standard. ESLint v10.0.0, veröffentlicht am
6. Februar 2026, entfernte das ältere Format `.eslintrc` und die Datei
`.eslintignore` vollständig.

## Warum es wichtig ist

Ein Linter rechtfertigt seinen Platz in dem Moment, in dem er das Zusammenführen
einer Änderung verhindert. ESLint entscheidet darüber mit seinem Exitcode, und
dieser richtet sich nach dem Schweregrad. Jede Regel steht auf `"off"`,
`"warn"` oder `"error"`. Ein Fehler beendet den Befehl mit 1. Eine Warnung wird
ausgegeben, der Befehl endet jedoch weiterhin mit 0, sofern `--max-warnings`
keine Obergrenze setzt. Diese Obergrenze ist standardmäßig deaktiviert. Exitcode
2 ist einer fehlerhaften Konfiguration oder einem internen Absturz vorbehalten.

Die eigentliche Teamentscheidung bei ESLint lautet also, was eine Warnung
bedeutet. Eine Warnung, die nie einen Build scheitern lässt, ist ein Hinweis.
Stehen vierzig Zeilen davon im Terminal, scrollen Menschen darüber hinweg.
Teams, deren Linter eine Grenze durchsetzen soll, setzen entweder jede wichtige
Regel auf `"error"` oder führen die Qualitätsprüfung mit `--max-warnings 0`
aus. In beiden Fällen besteht ein gesunder Branch die Lint-Prüfung ohne
Meldungen. Eine einzelne neue Zeile fällt dann auf und wird gelesen.

Der Nutzen liegt darin, was JavaScript durchlässt. Die Sprache lädt eine Datei,
die eine nicht deklarierte Variable verwendet, denselben Schlüssel zweimal in
einem Objektliteral definiert, einen Wert mit `NaN` über `===` vergleicht oder
hinter einem `return` Code enthält, der nie ausgeführt werden kann. Diese
Probleme können das Laden überstehen und unbemerkt bleiben oder bei der
Ausführung des Codes falsches Verhalten verursachen, auch in der Produktion.
Die Regeln des empfohlenen ESLint-Regelsatzes erkennen alle vier vor dem Review.
So kann die prüfende Person beim Lesen auf den Entwurf achten.

Es entstehen auch Kosten. In einer Konfiguration sammeln sich Meinungen. Eine
Regel, die bei korrektem Code anschlägt, gewöhnt Menschen daran, die Ausgabe
nicht mehr zu lesen; das ist schlechter als gar keine Regel. Ein Linter ist
außerdem nur so gut wie der Zeitpunkt seiner Ausführung: Läuft er nur im Editor
auf einigen Rechnern, prüft er nur einen Teil des Codes zu manchen Zeitpunkten.

## Wie es in der Praxis aussieht

ESLint war einer von sechs Lintern hinter
[einer Null-Warnungen-Vorgabe für sechs Sprachen](/de/portfolio/set-a-zero-warnings-bar-across-six-languages/).
Er prüfte TypeScript neben golangci-lint für Go, SQLFluff für SQL, Ruff für
Python, ShellCheck für Shellskripte und markdownlint für Markdown. Durchgesetzt
wurde die Vorgabe durch die oben beschriebene Schweregradentscheidung, einmal
für alle: Jede Lintermeldung ist ein Fehler, es gibt keine Stufe „warn“ zum
Ausweichen, und Unterdrückungen direkt im Quelltext sind verboten. Pre-Commit- und Pre-Push-Hooks führen Linter und Tests aus; Fehler innerhalb des
abgedeckten Regel- und Testumfangs verhindern den jeweiligen Commit oder Push.

Dasselbe Repository brauchte anschließend Regeln, die kein veröffentlichtes
Paket liefert: Regeln dafür, wie genau diese Codebasis funktionieren soll.
[Fünfzehn eigene ESLint-Regeln sichern die projektspezifischen Muster in TypeScript](/de/portfolio/built-a-268-check-guard-engine-for-the-repo/),
neben 274 Prüfskripten, von denen 268 in die Commit-Hooks eingebunden sind.
Einer dieser Validatoren prüft, ob jemand unbemerkt eine Unterdrückung im
Quelltext ergänzt hat. Die Schutzprüfungen haben 146 eigene Tests, weil eine
defekte Schutzprüfung alles durchlässt, ohne dass es jemand bemerkt. Die Seite
benennt den Preis ausdrücklich: Commits dauern lange.

Diese Website legt für ihre eigenen Build-Skripte denselben Maßstab in kleinerem
Umfang an. Ihre `eslint.config.mjs` beginnt mit `js.configs.recommended` und
ergänzt nur Regeln, die der Code zum Messzeitpunkt bereits erfüllte. Kommentare
dokumentieren eine erneute Messung am 2026-10-15 über alle 199 nicht als veraltet
markierten Regeln, nach der 21 weitere Regeln für Korrektheit statt Geschmacksfragen
aktiviert wurden. Jede Regel meldet Verstöße als Fehler. Auch `reportUnusedDisableDirectives`,
standardmäßig eine Warnung, wird zum Fehler hochgestuft. Ein Disable-Kommentar,
der nichts mehr unterdrückt, lässt den Lauf somit scheitern. Die Skripte
deklarieren globale Variablen für Node und Browser gemeinsam, weil die an
`page.evaluate` übergebenen Funktionsrümpfe im Browser laufen, wenige Zeilen
neben Code, der in Node ausgeführt wird.

## Wo es schiefgeht

Bei den meisten ESLint-Problemen tut der Linter genau das, was seine
Konfiguration vorgibt. Das ist nicht immer das, was das Team darin zu lesen glaubt.

**Der Build ist grün, und das Terminal ist voller Warnungen.** Warnungen lassen
den Exitcode bei 0. Die CI-Prüfung bleibt deshalb grün, während
die Liste jede Woche um einige Zeilen wächst. Irgendwann steht darin ein echter
Defekt, den niemand liest. Entscheiden Sie, welche Regeln wichtig sind, setzen
Sie diese auf `"error"`, schalten Sie den Rest ab und ergänzen Sie
`--max-warnings 0` in der Qualitätsprüfung, damit sich keine Warnungen mehr
ansammeln können.

**Ein Disable-Kommentar überlebt seinen Grund.** Eine Zeile wurde einmal aus
gutem Grund stummgeschaltet. Der Code darunter änderte sich, der Kommentar
blieb und verdeckt nun das nächste Problem dieser Zeile oder gar nichts.
Setzen Sie `linterOptions.reportUnusedDisableDirectives` auf `"error"`, damit
Direktiven, die nichts unterdrücken, den Lauf scheitern lassen. Verlangen Sie
bei den verbleibenden Kommentaren nach `--` eine Begründung, damit sie im
Review beurteilt werden können:

```js
// eslint-disable-next-line no-console -- printing is this CLI's output
console.log(report);
```

**Ein Upgrade ändert die geprüften Dateien.** Nach dem Wechsel zu v10 werden
Pfade plötzlich gemeldet, die `.eslintignore` vorher übersprang, oder ein
Verzeichnis folgt anderen Regeln. Version 10 berücksichtigt weder `.eslintrc.*`
noch `.eslintignore` und beginnt die Suche nach `eslint.config.*` jeweils im
Verzeichnis der geprüften Datei. Eine versehentliche Konfiguration in einem
Unterverzeichnis bestimmt deshalb nun dessen Regeln. Übertragen Sie Ausnahmen
in einen globalen Eintrag `ignores`, konvertieren Sie die alte Datei mit
`npx @eslint/migrate-config .eslintrc.json` und prüfen Sie das Ergebnis. Listen
Sie anschließend jede `eslint.config.*` im Verzeichnisbaum auf und entfernen
Sie die unbeabsichtigt verbliebenen Dateien.

**Browsercode wird als undefiniert gemeldet.** Ein Node-Skript, das Funktionen
an einen Browser übergibt, erhält `no-undef`-Fehler für `document` und `window`.
Jemand schaltet `no-undef` aus und verdeckt damit auch echte Tippfehler.
Deklarieren Sie über `languageOptions.globals` für die jeweiligen Dateien jede
Umgebung, in der der Code tatsächlich läuft.

**Eine eigene Regel lässt alles durch.** Nennt der Visitor einer Regel einen
Knotentyp, der nie vorkommt, oder ist ihre Bedingung umgekehrt, meldet sie
einfach nichts. Schweigen sieht genauso aus wie Regelkonformität. Testen Sie
jede eigene Regel mit ESLints `RuleTester`, mit Code, der bestehen muss, und
Code, der scheitern muss. Eine Regel, die keine Meldungen mehr liefert,
scheitert dann am eigenen Test, bevor sie der Codebasis schadet.

## Weiterführende Lektüre

- [Grundbegriffe](https://eslint.org/docs/latest/use/core-concepts/) — Regeln,
  Korrekturen, Plugins, Parser und Prozessoren nach den Definitionen des Projekts.
- [Konfigurationsdateien](https://eslint.org/docs/latest/use/configure/configuration-files)
  — das Flat-Config-Array, Dateimuster, globale Ausnahmen und das Zusammenführen
  von Objekten.
- [Regeln konfigurieren](https://eslint.org/docs/latest/use/configure/rules) —
  Schweregrade, Regeloptionen und Kommentare, die eine Regel für eine Zeile
  deaktivieren.
- [Referenz der Kommandozeilenschnittstelle](https://eslint.org/docs/latest/use/command-line-interface)
  — sämtliche Optionen, darunter `--max-warnings`, und die Bedeutung jedes Exitcodes.
- [ESLint v10.0.0 veröffentlicht](https://eslint.org/blog/2026/02/eslint-v10.0.0-released/)
  — die Entfernung von eslintrc und die neue Konfigurationssuche in den
  Versionshinweisen.
- [Eigene Regeln](https://eslint.org/docs/latest/extend/custom-rules) — eine
  Regel für den Syntaxbaum schreiben und mit `RuleTester` nachweisen, dass sie
  funktioniert.

<https://engineer.company/de/glossary/eslint/>
