ESLintでTypeScriptベースの設定ファイル（`eslint.config.ts`）を使えるようになった

2024年8月10日、TypeScriptで書かれた設定ファイルを実験的にサポートするESLint v9.9.0がリリースされました。

4月にリリースされたESLint v9.0.0では従来のeslintrcによる設定が非推奨となり、JavaScriptベースのFlat Config（eslint.config.js）に移行しました。

今回のリリースでは、TypeScriptベースの設定ファイル（eslint.config.ts、eslint.config.mts、eslint.config.cts）を実験的にサポートするようになりました。

これにより、TypeScriptによる入力補完の恩恵を受けながら、ESLintの設定ファイルを書けるようになります。

TypeScriptで設定ファイルを書く方法

TypeScriptベースの設定ファイルを利用するには、いくつかの設定が必要です。

まずは、軽量なTypeScriptのランタイム「jiti」をインストールします。jitiはESLintの依存関係に含まれていないため、手動でインストールする必要があります。

npm install -D jiti

次に、従来のFlat Configのファイル（eslint.config.jsなど）の拡張子を、TypeScript（eslint.config.tsなど）に変更します。記事執筆時点では、.ts、.mts、.ctsの拡張子がサポートされています。

必要であれば、設定ファイルに型定義を追加します。

実際にTypeScriptベースの設定ファイルを利用するには、ESLintの実行時にフラグを有効化する必要があります。

npx eslint --flag unstable_ts_config

これで、TypeScriptベースの設定ファイルを利用できるようになりました。

なお、ESLintが実行時に設定ファイルの型チェックを実施しない（型定義を単にコメントとして無視する）ことと、現時点ではjitiがtop-level awaitをサポートしていないことに注意してください。

Node.js v22.10.0以降ではjitiは不要（2025年4月12日追記）

Node.js v22.10.0以降では、TypeScriptファイルの実行がサポートされているため、jitiは不要です。

Node.jsがTypeScriptの実行をサポート！v23.6.0でデフォルトで有効化

TypeScriptのサポートがデフォルトで有効化されたNode.js v23.6.0がリリースされました。Enumなどの一部の機能を除くTypeScriptの基本的な機能を、ts-nodeやtsxなどのサードパーティのライブラリーなしで実行できるようになりました。

2025年1月10日

Node.js v22.10.0以上v23.6.0未満の場合は、Node.jsのフラグを有効化する必要があります。

npx --node-options='--experimental-strip-types' eslint --flag unstable_native_nodejs_ts_config

Node.js v23.6.0以降では、Node.jsのフラグは不要です。

npx eslint --flag unstable_native_nodejs_ts_config

VS Codeの拡張機能で利用する方法

VS CodeのESLint拡張機能では、フラグを有効化することでTypeScriptベースの設定ファイルを利用できます。

VS Codeのsettings.jsonを開き、次の設定を追加します。

1
{
2
    // ...その他の設定
3
    "eslint.options": {
4
        "flags": [
5
            "unstable_ts_config"
6
        ]
7
    }
8
}

設定を変更したあとは、VS Codeを再起動するかコマンドパレットから［ESLint: Restart ESLint Server］を実行してください。

参考

• feat: Add support for TS config files by aryaemami59 · Pull Request #18134 · eslint/eslint
• Release v9.9.0 · eslint/eslint
• ESLint v9.9.0 released - ESLint - Pluggable JavaScript Linter
• Support TS config files · Issue #1917 · microsoft/vscode-eslint

更新履歴

• 2025年1月21日：ESLint v9.18.0でフラグの有効化が不要になった旨を追記
• 2025年4月12日：Node.js v22.10.0以降ではjitiが不要になった旨を追記