# 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. 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, 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 — Regeln, Korrekturen, Plugins, Parser und Prozessoren nach den Definitionen des Projekts.
* Konfigurationsdateien — das Flat-Config-Array, Dateimuster, globale Ausnahmen und das Zusammenführen von Objekten.
* Regeln konfigurieren — Schweregrade, Regeloptionen und Kommentare, die eine Regel für eine Zeile deaktivieren.
* Referenz der Kommandozeilenschnittstelle — sämtliche Optionen, darunter `--max-warnings`, und die Bedeutung jedes Exitcodes.
* ESLint v10.0.0 veröffentlicht — die Entfernung von eslintrc und die neue Konfigurationssuche in den Versionshinweisen.
* Eigene Regeln — eine Regel für den Syntaxbaum schreiben und mit `RuleTester` nachweisen, dass sie funktioniert.

=> /de/portfolio/set-a-zero-warnings-bar-across-six-languages/ einer Null-Warnungen-Vorgabe für sechs Sprachen
=> /de/portfolio/built-a-268-check-guard-engine-for-the-repo/ Fünfzehn eigene ESLint-Regeln sichern die projektspezifischen Muster in TypeScript
=> https://eslint.org/docs/latest/use/core-concepts/ Grundbegriffe
=> https://eslint.org/docs/latest/use/configure/configuration-files Konfigurationsdateien
=> https://eslint.org/docs/latest/use/configure/rules Regeln konfigurieren
=> https://eslint.org/docs/latest/use/command-line-interface Referenz der Kommandozeilenschnittstelle
=> https://eslint.org/blog/2026/02/eslint-v10.0.0-released/ ESLint v10.0.0 veröffentlicht
=> https://eslint.org/docs/latest/extend/custom-rules Eigene Regeln

=> https://engineer.company/de/glossary/eslint/ Diese Seite im Web
