ESLint

どのようなものか

ESLintは、JavaScriptのソースコードを読み、設定した規則に照らし、違反
する場所を一つずつ報告する、オープンソースの静的解析ツールです。求め
られれば、簡単なものは自動で修正します。コマンドラインでは`eslint`と
いうコマンドで、検査するプロジェクトの開発用依存パッケージとして、
npmからインストールします。Nicholas
C. Zakasが2013年6月に始めたプロジェクトで、現在も、自らを設定可能な
JavaScriptリンターと紹介しています。

対象のプログラムは、一度も実行しません。パーサーが各ファイルをESTree
形式の抽象構文木に変えます。各規則は、小さいモジュールです。関数、比
較、`await`など、特定の種類のノードごとに呼ばれるよう要求します。渡
されたものを調べ、問題があれば、メッセージと位置を報告します。自動修
正を持つ規則もあります。プロジェクトが修正として認めるのは、プログラ
ムの動作を変えずに問題を直す変更だけで、`eslint
i--fix`がファイルへ適用します。代わりに提案を出す規則もあります。動作		engineer.company	70
iを変える場合があるため、人がエディターで一つずつ適用します。		engineer.company	70

この中心部分の周りは、ほぼすべて交換できます。プラグインは、規則、共
有できる設定、プロセッサー、ほかの言語への対応を追加するnpmパッケー
ジです。別のパーサーを使えば、TypeScriptなど、既定のパーサーが理解し
ない構文も読めます。プロセッサーは、Markdown文書のコードブロックな
ど、別のファイルからJavaScriptを取り出します。フォーマッターは、報告
の表示方法を変えます。プロジェクト自身が述べる考え方は、各規則が独立
し、無効にでき、それぞれの基準で警告や失敗を設定できる、というもので
す。

すべてを設定するのは、プロジェクトのルートに置く、一つのJavaScript
ファイルです。通常は`eslint.config.js`か、`.mjs`、`.cjs`の形式で、オ
ブジェクトの配列をエクスポートします。各オブジェクトが、対象ファイル
と、適用する規則、グローバル変数、パーサーのオプションを示し、後のオ
ブジェクトが前を上書きします。この構成をフラット設定と呼び、2024年4
月5日のESLint
v9.0.0で既定になりました。2026年2月6日公開のESLint
v10.0.0は、古い`.eslintrc`形式と`.eslintignore`ファイルを、完全に廃
止しました。

なぜ重要なのか

リンターが役立つ決定的な場面は、変更のマージを止めるときです。ESLint
は、終了コードで判断を伝え、その値は重大度に従います。各規則は、
`"off"`、`"warn"`、`"error"`のいずれかです。エラーがあれば、コマンド
は1で終了します。警告は表示しても、`--max-warnings`で上限を設けなけ
れば、終了コードは0のままです。この上限は、既定では無効です。終了
コード2は、設定の不備か内部の異常終了に使います。

つまり、ESLintを使うチームが本当に決めるのは、警告の意味です。ビルド
を失敗させない警告は、助言です。端末に四十行も並べば、読み飛ばされま
す。リンターに基準を守らせたいチームは、必要な規則をすべて`"error"`
にするか、品質ゲートで`--max-warnings
0`を使います。どちらでも、健全なブランチは、何の指摘もなく検査を通り
ます。新しい一行が出れば、気付いて読まれる知らせになります。

効果が分かるのは、JavaScriptが通してしまうコードです。宣言のない変数
を参照する、オブジェクトリテラルで同じキーを二回定義する、`NaN`を
`===`で比較する、`return`の後に実行不能なコードを残す。言語は、こう
したファイルも読み込みます。問題が読み込みを通過して気付かれないこと
も、実行時に、本番を含めて誤動作を起こすこともあります。ESLintの推奨
規則は、四つともレビュー前に検出します。レビューする人は、設計を読む
ことへ集中できます。

負担もあります。設定には、好みが積み重なります。正しいコードに反応す
る規則は、出力を読まない習慣を付け、規則がないより悪い結果になりま
す。リンターの価値は、いつ実行するかによっても制限されます。一部のマ
シンのエディターでしか動かないものは、限られた機会に、一部のコードし
か調べません。

実際の活用例

ESLintは、六つの言語へ警告ゼロの基準を設けた仕事で使った、六つのリン
ターの一つでした。TypeScriptを担当し、Goのgolangci-lint、SQLの
SQLFluff、PythonのRuff、シェルスクリプトのShellCheck、Markdownの
markdownlintと並びました。基準を支えたのは、重大度について、全員に共
通する答えを一度に決めたことです。すべての指摘はエラーで、逃げ込める
「warn」の段階はなく、コード内の抑制指定は禁止しました。コミット前と
プッシュ前のフックが、リンターとテストを実行します。対象となる規則や
テストに違反すると、対応するコミットまたはプッシュを止めます。

同じリポジトリには、その後、公開パッケージにはない規則も必要になりま
した。そのコードベース特有の作り方を守る規則です。独自のESLint規則十
五個で、TypeScriptのプロジェクト固有のパターンを守りました。ほかに
274個の検査スクリプトがあり、268個をコミットフックへ登録しました。一
つのバリデーターは、コード内の抑制指定を、気付かれないまま追加してい
ないかを確かめます。検査機構自体にも、146個のテストがあります。壊れ
た検査は、すべてを通し、誰も気付かないためです。事例は代償も明記しま
す。コミットに時間がかかります。

このサイトも、より小さい規模で、ビルドスクリプトに同じ基準を適用しま
す。`eslint.config.mjs`は`js.configs.recommended`から始め、測定時
に、コードがすでに満たしていた規則だけを加えます。コメントには、
2026-10-15に、非推奨に指定されていない199個の規則全体を再測定し、好
みではなく正しさを調べる規則を、さらに21個有効にした記録があります。
すべての規則は、違反をエラーとします。既定では警告の
`reportUnusedDisableDirectives`も、エラーへ上げます。何も抑制しなく
なった無効化コメントが、検査を失敗させるためです。スクリプトは、Node
とブラウザーのグローバル変数を、両方宣言します。`page.evaluate`へ渡
す関数本体は、Nodeで動くコードの数行隣にあっても、ブラウザー内で動く
ためです。

問題が起きるところ

ESLintの問題の多くは、リンターが、設定どおりに動いていることです。そ
の設定の意味が、チームの理解と一致するとは限りません。

ビルドは緑なのに、端末が警告で埋まります。
警告では終了コードが0のままなので、継続的インテグレーションは通りま
す。一覧は毎週数行ずつ増え、やがて本物の欠陥が、読まれないまま紛れ込
みます。必要な規則を決め、`"error"`にし、ほかは無効にします。品質
ゲートに`--max-warnings
0`も加え、警告を蓄積できなくします。

無効化コメントだけが、理由を失って残ります。
かつて正当な理由で、その行の指摘を抑えました。下のコードが変わっても
コメントは残り、その行の次の問題を隠すか、何も抑えなくなります。
`linterOptions.reportUnusedDisableDirectives`を`"error"`にし、何も抑
えない指定が検査を失敗させるようにします。残すものには、`--`の後に理
由を求め、レビューで判断できるようにします。

```js
// eslint-disable-next-line no-console -- 出力を表示するのがこのCLIの役割
console.log(report);
```

更新で、検査するファイルが変わります。
v10へ移ると、`.eslintignore`で除外していたパスが、突然報告されたり、
一つのフォルダーが違う規則に従い始めたりします。バージョン10は、
`.eslintrc.*`も`.eslintignore`も使いません。検査するファイルごとに、
そのファイルのディレクトリーから`eslint.config.*`を探します。そのた
め、サブフォルダーに残った予定外の設定が、そのフォルダーに適用されま
す。除外は、グローバルな`ignores`項目へ移します。`npx
@eslint/migrate-config
i.eslintrc.json`で古いファイルを変換し、出力をレビューします。その		engineer.company	70
i後、ツリー内のすべての`eslint.config.*`を一覧にし、残すつもりのな		engineer.company	70
iかったものを削除します。		engineer.company	70

ブラウザーのコードが、未定義と報告されます。
ブラウザーへ関数を渡すNodeスクリプトで、`document`や`window`に
`no-undef`エラーが出ます。そこで`no-undef`を無効にすると、本物のタイ
プミスも隠れます。各ファイルが実際に動くすべての環境を、
`languageOptions.globals`で、そのファイルに対して宣言します。

独自の規則が、すべてを通します。
規則のビジターが、対象のコードに一度も現れない種類のノードを指定した
り、条件が逆だったりすると、何も報告しません。沈黙は、規則を守った結
果と同じに見えます。各独自規則をESLintの`RuleTester`で試し、通るべき
コードと、失敗すべきコードを渡します。報告しなくなった規則が、コード
ベースを守れなくなる前に、自分のテストで失敗するようにします。

参考資料

  * 基本概念 — プロジェクトが定義する、規則、修正、プラグイン、パー
サー、プロセッサーです。

  * 設定ファイル — フラット設定の配列、ファイルパターン、グローバル
な除外、オブジェクトの結合方法です。

  * 規則の設定 — 重大度、規則のオプション、特定の行で規則を無効にす
るコメントです。

  * コマンドラインインターフェースのリファレンス —
`--max-warnings`を含むすべてのオプションと、各終了コードの意味です。

  * ESLint v10.0.0公開 — eslintrcの廃止と、新しい設定の探索方法を説
明するリリースノートです。

  * 独自規則 — 構文木を調べる規則を書き、`RuleTester`で確かめる方法
です。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/eslint/	engineer.company	70
