Install & Compatibility
Where this runs
tested against v? · npm install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslnode 18–226 runs
build_error
glibcnode 18–226 runs
build_error
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
plugin (default)
✓ import eslintPluginEmber from 'eslint-plugin-ember'
✗ const eslintPluginEmber = require('eslint-plugin-ember')
ESM-only since v13? Actually this package ships both CJS and ESM; require() still works. But for flat config, ESM import is recommended.
configs/recommended
✓ import recommended from 'eslint-plugin-ember/configs/recommended'
✗ require('eslint-plugin-ember/configs/recommended')
Use ESM import for flat config. CJS require is still possible but deprecated in v13+.
rules
✓ import { rules } from 'eslint-plugin-ember'
✗ import * as emberPlugin from 'eslint-plugin-ember'; const rules = emberPlugin.rules
Named export 'rules' is available as an object of all rule definitions.
configs/recommended-gts
✓ import gtsConfig from 'eslint-plugin-ember/configs/recommended-gts'
✗ require('eslint-plugin-ember/configs/recommended-gts')
For .gts files; must be used with ember-eslint-parser.
Minimal flat config setup with recommended rules and gjs/gts override example.
// 1. Install
// npm install --save-dev eslint-plugin-ember
// 2. eslint.config.js (flat config)
import eslintPluginEmberRecommended from 'eslint-plugin-ember/configs/recommended';
export default [
...eslintPluginEmberRecommended,
{
rules: {
'ember/no-replace-test-comments': 'error',
},
},
];
// 3. For gjs/gts files, also install:
// npm install --save-dev ember-eslint-parser @typescript-eslint/parser
// Then add overrides:
// {
// files: ['**/*.gjs'],
// parser: 'ember-eslint-parser',
// ...eslintPluginEmberRecommended,
// ...require('eslint-plugin-ember/configs/recommended-gjs'),
// }
Errors
Common errors & fixes
ESLint couldn't find the config 'plugin:ember/recommended'.
The plugin is not installed or not properly loaded in a flat config environment.
fixUse import recommended from 'eslint-plugin-ember/configs/recommended' and spread it in eslint.config.js.
Parsing error: Cannot find module 'ember-eslint-parser'
The ember-eslint-parser package is not installed, but required for .gjs/.gts files.
fixnpm install --save-dev ember-eslint-parser
Error: ESLint configuration in .eslintrc is deprecated. Use eslint.config.js instead.
Legacy .eslintrc format is no longer supported with ESLint 9+.
fixMigrate to eslint.config.js flat config.
TypeError: context.getSource() is not a function
ESLint 10 removed deprecated context methods; v13 uses new API, but older plugin version might still call old methods.
fixUpdate plugin to v13+ and ESLint to >=8.40.
Audit
Dependencies
@typescript-eslint/parseroptionalRequired peer dependency for parsing TypeScript (and gts) files
eslintrequiredPeer dependency; must be >= 8.40.0 for v13 compatibility