{"canonical_url":"https://engineer.company/de/glossary/eslint/","content_markdown":"# ESLint\n\n## Was es ist\n\nESLint ist ein quelloffenes Werkzeug zur statischen Analyse. Es liest\nJavaScript-Quellcode, prüft ihn gegen einen konfigurierten Regelsatz und meldet\njede Stelle, die eine Regel verletzt. Auf Wunsch repariert es einfachere Fälle\nselbst. Auf der Kommandozeile heißt der Befehl `eslint`; er wird über npm als\nEntwicklungsabhängigkeit des geprüften Projekts installiert. Nicholas C. Zakas\nbegann das Projekt im Juni 2013. Es stellt sich weiterhin als konfigurierbarer\nJavaScript-Linter vor.\n\nDas geprüfte Programm wird dabei nie ausgeführt. Ein Parser verwandelt jede Datei in\neinen abstrakten Syntaxbaum im ESTree-Format. Jede Regel ist ein kleines Modul,\ndas für bestimmte Knotentypen aufgerufen werden möchte: jede Funktion, jeden\nVergleich, jedes `await`. Die Regel untersucht den übergebenen Knoten und meldet\nbei einem Problem eine Nachricht samt Position. Manche Regeln enthalten auch\neine Korrektur. Das Projekt akzeptiert solche Änderungen nur, wenn sie das\nProblem beheben, ohne das Verhalten des Programms zu ändern. `eslint --fix`\nwendet sie auf die Dateien an. Andere Regeln bieten stattdessen Vorschläge,\ndie das Verhalten ändern können und deshalb einzeln von einem Menschen im\nEditor angewendet werden.\n\nFast alles um diesen Kern lässt sich austauschen. Plugins sind npm-Pakete, die\nRegeln, gemeinsam nutzbare Konfigurationen, Prozessoren oder Unterstützung für andere\nSprachen ergänzen. Mit einem anderen Parser kann ESLint Syntax lesen, die der\nStandardparser nicht versteht, etwa TypeScript. Prozessoren extrahieren\nJavaScript aus anderen Dateien, beispielsweise aus Codeblöcken in einem\nMarkdown-Dokument. Formatter ändern die Ausgabe des Berichts. Zur eigenen\nPhilosophie erklärt das Projekt, dass jede Regel eigenständig ist, sich\nabschalten lässt und unabhängig auf Warnung oder Fehler eingestellt werden kann.\n\nAll das wird in einer JavaScript-Datei im Projektstammverzeichnis konfiguriert,\nüblicherweise `eslint.config.js` oder einer Variante mit `.mjs` oder `.cjs`.\nSie exportiert ein Array von Objekten. Jedes Objekt nennt die betroffenen Dateien\nsowie deren Regeln, globale Variablen und Parseroptionen; spätere Objekte\nüberschreiben frühere. Dieser Aufbau heißt Flat Config und wurde mit ESLint\nv9.0.0 am 5. April 2024 zum Standard. ESLint v10.0.0, veröffentlicht am\n6. Februar 2026, entfernte das ältere Format `.eslintrc` und die Datei\n`.eslintignore` vollständig.\n\n## Warum es wichtig ist\n\nEin Linter rechtfertigt seinen Platz in dem Moment, in dem er das Zusammenführen\neiner Änderung verhindert. ESLint entscheidet darüber mit seinem Exitcode, und\ndieser richtet sich nach dem Schweregrad. Jede Regel steht auf `\"off\"`,\n`\"warn\"` oder `\"error\"`. Ein Fehler beendet den Befehl mit 1. Eine Warnung wird\nausgegeben, der Befehl endet jedoch weiterhin mit 0, sofern `--max-warnings`\nkeine Obergrenze setzt. Diese Obergrenze ist standardmäßig deaktiviert. Exitcode\n2 ist einer fehlerhaften Konfiguration oder einem internen Absturz vorbehalten.\n\nDie eigentliche Teamentscheidung bei ESLint lautet also, was eine Warnung\nbedeutet. Eine Warnung, die nie einen Build scheitern lässt, ist ein Hinweis.\nStehen vierzig Zeilen davon im Terminal, scrollen Menschen darüber hinweg.\nTeams, deren Linter eine Grenze durchsetzen soll, setzen entweder jede wichtige\nRegel auf `\"error\"` oder führen die Qualitätsprüfung mit `--max-warnings 0`\naus. In beiden Fällen besteht ein gesunder Branch die Lint-Prüfung ohne\nMeldungen. Eine einzelne neue Zeile fällt dann auf und wird gelesen.\n\nDer Nutzen liegt darin, was JavaScript durchlässt. Die Sprache lädt eine Datei,\ndie eine nicht deklarierte Variable verwendet, denselben Schlüssel zweimal in\neinem Objektliteral definiert, einen Wert mit `NaN` über `===` vergleicht oder\nhinter einem `return` Code enthält, der nie ausgeführt werden kann. Diese\nProbleme können das Laden überstehen und unbemerkt bleiben oder bei der\nAusführung des Codes falsches Verhalten verursachen, auch in der Produktion.\nDie Regeln des empfohlenen ESLint-Regelsatzes erkennen alle vier vor dem Review.\nSo kann die prüfende Person beim Lesen auf den Entwurf achten.\n\nEs entstehen auch Kosten. In einer Konfiguration sammeln sich Meinungen. Eine\nRegel, die bei korrektem Code anschlägt, gewöhnt Menschen daran, die Ausgabe\nnicht mehr zu lesen; das ist schlechter als gar keine Regel. Ein Linter ist\naußerdem nur so gut wie der Zeitpunkt seiner Ausführung: Läuft er nur im Editor\nauf einigen Rechnern, prüft er nur einen Teil des Codes zu manchen Zeitpunkten.\n\n## Wie es in der Praxis aussieht\n\nESLint war einer von sechs Lintern hinter\n[einer Null-Warnungen-Vorgabe für sechs Sprachen](/de/portfolio/set-a-zero-warnings-bar-across-six-languages/).\nEr prüfte TypeScript neben golangci-lint für Go, SQLFluff für SQL, Ruff für\nPython, ShellCheck für Shellskripte und markdownlint für Markdown. Durchgesetzt\nwurde die Vorgabe durch die oben beschriebene Schweregradentscheidung, einmal\nfür alle: Jede Lintermeldung ist ein Fehler, es gibt keine Stufe „warn“ zum\nAusweichen, und Unterdrückungen direkt im Quelltext sind verboten. Pre-Commit- und Pre-Push-Hooks führen Linter und Tests aus; Fehler innerhalb des\nabgedeckten Regel- und Testumfangs verhindern den jeweiligen Commit oder Push.\n\nDasselbe Repository brauchte anschließend Regeln, die kein veröffentlichtes\nPaket liefert: Regeln dafür, wie genau diese Codebasis funktionieren soll.\n[Fünfzehn eigene ESLint-Regeln sichern die projektspezifischen Muster in TypeScript](/de/portfolio/built-a-268-check-guard-engine-for-the-repo/),\nneben 274 Prüfskripten, von denen 268 in die Commit-Hooks eingebunden sind.\nEiner dieser Validatoren prüft, ob jemand unbemerkt eine Unterdrückung im\nQuelltext ergänzt hat. Die Schutzprüfungen haben 146 eigene Tests, weil eine\ndefekte Schutzprüfung alles durchlässt, ohne dass es jemand bemerkt. Die Seite\nbenennt den Preis ausdrücklich: Commits dauern lange.\n\nDiese Website legt für ihre eigenen Build-Skripte denselben Maßstab in kleinerem\nUmfang an. Ihre `eslint.config.mjs` beginnt mit `js.configs.recommended` und\nergänzt nur Regeln, die der Code zum Messzeitpunkt bereits erfüllte. Kommentare\ndokumentieren eine erneute Messung am 2026-10-15 über alle 199 nicht als veraltet\nmarkierten Regeln, nach der 21 weitere Regeln für Korrektheit statt Geschmacksfragen\naktiviert wurden. Jede Regel meldet Verstöße als Fehler. Auch `reportUnusedDisableDirectives`,\nstandardmäßig eine Warnung, wird zum Fehler hochgestuft. Ein Disable-Kommentar,\nder nichts mehr unterdrückt, lässt den Lauf somit scheitern. Die Skripte\ndeklarieren globale Variablen für Node und Browser gemeinsam, weil die an\n`page.evaluate` übergebenen Funktionsrümpfe im Browser laufen, wenige Zeilen\nneben Code, der in Node ausgeführt wird.\n\n## Wo es schiefgeht\n\nBei den meisten ESLint-Problemen tut der Linter genau das, was seine\nKonfiguration vorgibt. Das ist nicht immer das, was das Team darin zu lesen glaubt.\n\n**Der Build ist grün, und das Terminal ist voller Warnungen.** Warnungen lassen\nden Exitcode bei 0. Die CI-Prüfung bleibt deshalb grün, während\ndie Liste jede Woche um einige Zeilen wächst. Irgendwann steht darin ein echter\nDefekt, den niemand liest. Entscheiden Sie, welche Regeln wichtig sind, setzen\nSie diese auf `\"error\"`, schalten Sie den Rest ab und ergänzen Sie\n`--max-warnings 0` in der Qualitätsprüfung, damit sich keine Warnungen mehr\nansammeln können.\n\n**Ein Disable-Kommentar überlebt seinen Grund.** Eine Zeile wurde einmal aus\ngutem Grund stummgeschaltet. Der Code darunter änderte sich, der Kommentar\nblieb und verdeckt nun das nächste Problem dieser Zeile oder gar nichts.\nSetzen Sie `linterOptions.reportUnusedDisableDirectives` auf `\"error\"`, damit\nDirektiven, die nichts unterdrücken, den Lauf scheitern lassen. Verlangen Sie\nbei den verbleibenden Kommentaren nach `--` eine Begründung, damit sie im\nReview beurteilt werden können:\n\n```js\n// eslint-disable-next-line no-console -- printing is this CLI's output\nconsole.log(report);\n```\n\n**Ein Upgrade ändert die geprüften Dateien.** Nach dem Wechsel zu v10 werden\nPfade plötzlich gemeldet, die `.eslintignore` vorher übersprang, oder ein\nVerzeichnis folgt anderen Regeln. Version 10 berücksichtigt weder `.eslintrc.*`\nnoch `.eslintignore` und beginnt die Suche nach `eslint.config.*` jeweils im\nVerzeichnis der geprüften Datei. Eine versehentliche Konfiguration in einem\nUnterverzeichnis bestimmt deshalb nun dessen Regeln. Übertragen Sie Ausnahmen\nin einen globalen Eintrag `ignores`, konvertieren Sie die alte Datei mit\n`npx @eslint/migrate-config .eslintrc.json` und prüfen Sie das Ergebnis. Listen\nSie anschließend jede `eslint.config.*` im Verzeichnisbaum auf und entfernen\nSie die unbeabsichtigt verbliebenen Dateien.\n\n**Browsercode wird als undefiniert gemeldet.** Ein Node-Skript, das Funktionen\nan einen Browser übergibt, erhält `no-undef`-Fehler für `document` und `window`.\nJemand schaltet `no-undef` aus und verdeckt damit auch echte Tippfehler.\nDeklarieren Sie über `languageOptions.globals` für die jeweiligen Dateien jede\nUmgebung, in der der Code tatsächlich läuft.\n\n**Eine eigene Regel lässt alles durch.** Nennt der Visitor einer Regel einen\nKnotentyp, der nie vorkommt, oder ist ihre Bedingung umgekehrt, meldet sie\neinfach nichts. Schweigen sieht genauso aus wie Regelkonformität. Testen Sie\njede eigene Regel mit ESLints `RuleTester`, mit Code, der bestehen muss, und\nCode, der scheitern muss. Eine Regel, die keine Meldungen mehr liefert,\nscheitert dann am eigenen Test, bevor sie der Codebasis schadet.\n\n## Weiterführende Lektüre\n\n- [Grundbegriffe](https://eslint.org/docs/latest/use/core-concepts/) — Regeln,\n  Korrekturen, Plugins, Parser und Prozessoren nach den Definitionen des Projekts.\n- [Konfigurationsdateien](https://eslint.org/docs/latest/use/configure/configuration-files)\n  — das Flat-Config-Array, Dateimuster, globale Ausnahmen und das Zusammenführen\n  von Objekten.\n- [Regeln konfigurieren](https://eslint.org/docs/latest/use/configure/rules) —\n  Schweregrade, Regeloptionen und Kommentare, die eine Regel für eine Zeile\n  deaktivieren.\n- [Referenz der Kommandozeilenschnittstelle](https://eslint.org/docs/latest/use/command-line-interface)\n  — sämtliche Optionen, darunter `--max-warnings`, und die Bedeutung jedes Exitcodes.\n- [ESLint v10.0.0 veröffentlicht](https://eslint.org/blog/2026/02/eslint-v10.0.0-released/)\n  — die Entfernung von eslintrc und die neue Konfigurationssuche in den\n  Versionshinweisen.\n- [Eigene Regeln](https://eslint.org/docs/latest/extend/custom-rules) — eine\n  Regel für den Syntaxbaum schreiben und mit `RuleTester` nachweisen, dass sie\n  funktioniert.\n\n\u003chttps://engineer.company/de/glossary/eslint/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Wie ESLint JavaScript als Syntaxbaum prüft, wann Warnungen einen Build scheitern lassen und wie eine Konfiguration unbemerkt Prüfungen verliert.","formats":{"gemtext":"https://engineer.company/de/glossary/eslint/index.gmi","gopher":"https://engineer.company/de/glossary/eslint/gophermap","html":"https://engineer.company/de/glossary/eslint/","json":"https://engineer.company/de/glossary/eslint/index.json","markdown":"https://engineer.company/de/glossary/eslint/index.md","pdf":"https://engineer.company/de/glossary/eslint/index.pdf"},"kind":"page","language":"de","title":"Was ist ESLint?","url":"https://engineer.company/de/glossary/eslint/","version":1}