できない.dev

ESLint「Unexpected non-object config at user-defined index 0」の原因と直し方

Unexpected non-object config at user-defined index 0 は、flat config の配列に eslint:recommended を文字列で書くと出る。
@eslint/js の js.configs.recommended に置き換えれば直る。

公開:

症状できない · exit 2
npx eslint src
…
TypeError: Config (unnamed): Unexpected non-object config at user-defined index 0.
    at wrapConfigErrorWithDetails (/tmp/mJid/node_modules/eslint/lib/config/flat-config-array.js:63:9)
    at /tmp/mJid/node_modules/eslint/lib/config/flat-config-array.js:140:11
    at async ConfigLoader.calculateConfigArray (/tmp/mJid/node_modules/eslint/lib/config/config-loader.js:672:3)
解決後できた · exit 0
npx eslint src

2026-11-07 に node:24(ESLint 10.14.0 / Node.js 24.22.2) で実際に打って取った出力。検証環境の詳細

要約

TypeError: Config (unnamed): Unexpected non-object config at user-defined index 0. は、flat config(eslint.config.js)の配列に、オブジェクトでない値を置いたときに出るエラーだ。
よくあるのは、ESLint 8 の .eslintrc で書いていた "eslint:recommended" を、配列に文字列のまま書いたものである。
9.0 からは配列に設定のオブジェクトしか置けず、どのファイルも検査する前に止まる。
終了コードは 2 になる。

@eslint/js の js.configs.recommended に置き換えれば直る。
index 0 は、配列の何番目の要素が悪いかを 0 から数えた位置である。

実行例

node:24 のコンテナで ESLint 10.14.0 を動かすと、配列に置いた文字列も打ち間違えた設定も終了コード 2 で止まり、エラーの index は置いた位置を指していた。
js.configs.recommended と "js/recommended" に置き換えたあとは、終了コード 0 で通った。

$ cat eslint.config.js
module.exports = ["eslint:recommended"];
$ npx eslint src
Oops! Something went wrong! :(
 
ESLint: 10.14.0
 
TypeError: Config (unnamed): Unexpected non-object config at user-defined index 0.
    at wrapConfigErrorWithDetails (/tmp/mJid/node_modules/eslint/lib/config/flat-config-array.js:63:9)
    at /tmp/mJid/node_modules/eslint/lib/config/flat-config-array.js:140:11
    at async ConfigLoader.calculateConfigArray (/tmp/mJid/node_modules/eslint/lib/config/config-loader.js:672:3)
    at async #calculateConfigArray (/tmp/mJid/node_modules/eslint/lib/config/config-loader.js:369:19)
    at async entryFilter (/tmp/mJid/node_modules/eslint/lib/eslint/eslint-helpers.js:324:5)
    at async NodeHfs.<anonymous> (file:///tmp/mJid/node_modules/@humanfs/core/src/hfs.js:574:24)
    at async NodeHfs.walk (file:///tmp/mJid/node_modules/@humanfs/core/src/hfs.js:614:3)
    at async globSearch (/tmp/mJid/node_modules/eslint/lib/eslint/eslint-helpers.js:366:20)
    at async Promise.allSettled (index 0)
    at async globMultiSearch (/tmp/mJid/node_modules/eslint/lib/eslint/eslint-helpers.js:457:18)
$ echo $?
2
$ cat eslint.config.js
const js = require("@eslint/js");
 
module.exports = [js.configs.recommended];
$ npx eslint src
$ echo $?
0
$ cat eslint.config.js
const js = require("@eslint/js");
 
module.exports = [js.configs.recommended, js.configs.recomended];
$ npx eslint src
Oops! Something went wrong! :(
 
ESLint: 10.14.0
 
TypeError: Config (unnamed): Unexpected undefined config at user-defined index 1.
    at wrapConfigErrorWithDetails (/tmp/mJid/node_modules/eslint/lib/config/flat-config-array.js:63:9)
    at /tmp/mJid/node_modules/eslint/lib/config/flat-config-array.js:140:11
    at async ConfigLoader.calculateConfigArray (/tmp/mJid/node_modules/eslint/lib/config/config-loader.js:672:3)
    at async #calculateConfigArray (/tmp/mJid/node_modules/eslint/lib/config/config-loader.js:369:19)
    at async entryFilter (/tmp/mJid/node_modules/eslint/lib/eslint/eslint-helpers.js:324:5)
    at async NodeHfs.<anonymous> (file:///tmp/mJid/node_modules/@humanfs/core/src/hfs.js:574:24)
    at async NodeHfs.walk (file:///tmp/mJid/node_modules/@humanfs/core/src/hfs.js:614:3)
    at async globSearch (/tmp/mJid/node_modules/eslint/lib/eslint/eslint-helpers.js:366:20)
    at async Promise.allSettled (index 0)
    at async globMultiSearch (/tmp/mJid/node_modules/eslint/lib/eslint/eslint-helpers.js:457:18)
$ echo $?
2
$ cat eslint.config.mjs
import { defineConfig } from "eslint/config";
 
export default defineConfig([
  {
    files: ["**/*.js"],
    extends: ["eslint:recommended"],
  },
]);
$ npx eslint src
Oops! Something went wrong! :(
 
ESLint: 10.14.0
 
TypeError: Plugin "" not found.
    at findPluginConfig (/tmp/mJid/node_modules/@eslint/config-helpers/dist/cjs/index.cjs:264:9)
    at /tmp/mJid/node_modules/@eslint/config-helpers/dist/cjs/index.cjs:433:25
    at Array.map (<anonymous>)
    at processExtends (/tmp/mJid/node_modules/@eslint/config-helpers/dist/cjs/index.cjs:431:36)
    at /tmp/mJid/node_modules/@eslint/config-helpers/dist/cjs/index.cjs:507:38
    at Array.flatMap (<anonymous>)
    at processConfigList (/tmp/mJid/node_modules/@eslint/config-helpers/dist/cjs/index.cjs:507:20)
    at defineConfig (/tmp/mJid/node_modules/@eslint/config-helpers/dist/cjs/index.cjs:543:9)
    at file:///tmp/mJid/eslint.config.mjs?mtime=1794002269333:3:16
    at ModuleJob.run (node:internal/modules/esm/module_job:561:25)
$ echo $?
2
$ cat eslint.config.mjs
import js from "@eslint/js";
import { defineConfig } from "eslint/config";
 
export default defineConfig([
  {
    files: ["**/*.js"],
    plugins: { js },
    extends: ["js/recommended"],
  },
]);
$ npx eslint src
$ echo $?
0

— 2026-11-07 時点の出力

検証環境Node.js 24.22.2 / npm 11.19.1 / Python 3.11.2 / 2026-11-07 検証(ほか 2 件)
検証日
実行環境
node:24 Debian GNU/Linux 12 (bookworm)
バージョン
  • Node.js 24.22.2
  • npm 11.19.1
  • Python 3.11.2
  • Git 2.39.5
  • ESLint 10.14.0

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. js.configs.recommended に置き換える

@eslint/js は ESLint 本体の依存として入っているが、設定ファイルから読み込むので、自分の package.json にも書く。

npm install -D @eslint/js
const js = require("@eslint/js");
 
module.exports = [js.configs.recommended];

ESLint 9 のプロジェクトでは npm install -D @eslint/js@9 と版をそろえる。
版を付けないと 10 系が選ばれ、peerDependencies が合わずに ERESOLVE で止まる(ESLint 8 から 9 への移行ページの 1 つ目の節で確かめた)。

2. extends に書くときは plugins に js を足す

defineConfig() の extends には文字列も書ける。
ただし "eslint:recommended" とは書けず、TypeError: Plugin "" not found. で止まる。
plugins に js を登録し、"js/recommended" と書く。

import js from "@eslint/js";
import { defineConfig } from "eslint/config";
 
export default defineConfig([
  {
    files: ["**/*.js"],
    plugins: { js },
    extends: ["js/recommended"],
  },
]);

3. プラグインの設定名をオブジェクトに替える

"plugin:react/recommended" のような設定名は、プラグインが flat config 用に出している設定のオブジェクトに置き換える。
オブジェクトの名前はプラグインごとに違うので、プラグインの README で確かめる。

よくある原因

  1. "eslint:recommended" を文字列で書いた。
    ESLint 8 から 9 への移行ページの実測では、8.57.1 の flat config は非推奨の警告を出して受け付け、9.39.5 は止まった。
    10.14.0 でも止まる。
  2. "plugin:react/recommended" のような eslintrc 形式の設定名を移した。
    プラグインの設定名も文字列なので、同じエラーになる。
  3. 設定の名前を打ち間違えた。
    js.configs.recomended のように存在しない設定を置くと、配列の要素が undefined になる。
    配列の 2 番目に置くと、Unexpected undefined config at user-defined index 1. と出た。