graphql-eslint with ESLint 9/10: 'ESLint couldn't find an eslint.config.* file' (.eslintrc ignored) and 'Key "parser": Expected object with parse() or parseForESLint() method'
Goal: lint .graphql operation files against a local SDL (here a schema rebuilt for the Matterport Model API) with @graphql-eslint/eslint-plugin, in a node:22 container.
Failure 1: a classic .eslintrc.json with "parser": "@graphql-eslint/eslint-plugin" and parserOptions.schema, then npx eslint queries/*.graphql. An unpinned npm install eslint pulled ESLint 10.15.0, which prints ESLint couldn't find an eslint.config.* file. From ESLint v9.0.0, the default configuration file is now eslint.config.*. .eslintrc is no longer read.
Failure 2: a flat config that passes the plugin object as the parser, languageOptions: { parser: graphqlPlugin, parserOptions: { schema: './schema.graphql' } }, fails with TypeError: Key "languageOptions": Key "parser": Expected object with parse() or parseForESLint() method. A Node warning [MODULE_TYPELESS_PACKAGE_JSON] ... Reparsing as ES module also appears, because eslint.config.js uses import without "type": "module".
Working config (tested with ESLint 10.15.0 and @graphql-eslint/eslint-plugin 4.4.2), saved as eslint.config.mjs so it is ESM regardless of package.json:
import graphqlPlugin from '@graphql-eslint/eslint-plugin';
export default [{
files: ['**/*.graphql'],
languageOptions: {
parser: graphqlPlugin.parser,
parserOptions: { graphQLConfig: { schema: './schema.graphql', documents: './queries/*.graphql' } },
},
plugins: { '@graphql-eslint': graphqlPlugin },
rules: {
'@graphql-eslint/fields-on-correct-type': 'error',
'@graphql-eslint/known-type-names': 'error',
'@graphql-eslint/no-deprecated': 'warn',
'@graphql-eslint/no-anonymous-operations': 'warn',
},
}];In v4 the schema goes under parserOptions.graphQLConfig (or a graphql.config file), not the old top-level parserOptions.schema. Schema-aware rules need it.
Verify with a deliberately wrong query: geolocation { latitude } reports Cannot query field "latitude" on type "GeoLocation". Did you mean "altitude"? @graphql-eslint/fields-on-correct-type. On the Model API, geolocation has lat/long and geocoordinates has latitude/longitude.