@enonic/eslint-config
v2.0.0
Published
ESLint rules for JavaScript and TypeScript by Enonic.
Downloads
1,655
Readme
Enonic ESLint Config
Install
- Install the latest version of the config:
npm install --save-dev @enonic/eslint-config
- Install the correct versions of each package, which are listed by the command:
npm info "@enonic/eslint-config@latest" peerDependencies
If you DON'T need to lint TypeScript, you should skip this step (see the vanilla configuration).
Make sure you intall the same version of @typescript-eslint/eslint-plugin
and @typescript-eslint/parser
packages.
Usage
.eslintrc.json
{
"extends": "@enonic/eslint-config",
"overrides": [
{
"files": ["*.ts", "*.tsx"],
"parserOptions": {
"project": "./tsconfig.json"
}
}
]
}
Some of the rules require parserServices
to be generated, therefore project
property must be explicitly set. Take a note, that TypeScript configuration is isolated by the *.ts
/*.tsx
scope.
Configuration
Aside from @enonic/eslint-config
, this package contains four more configurations:
Standalone
@enonic/eslint-config/vanilla
should replace default configuration in JavaScript-only projects.@enonic/eslint-config/typescript
should replace default configuration in TypeScript-only projects.
Helpers
@enonic/eslint-config/browser
adds additional configuration for linting browser files (assets).@enonic/eslint-config/xp
adds XP global variables and allows to lint files that will be used by XP.
Helpers must be combined with the default, vanilla, or typescript configuration.
XP and Browser
Your project may contain both server-side and client-side files. In this case, it might be reasonable to use overrides, to prevent specific config to be applied for improper files:
.eslintrc.json
{
"extends": "@enonic/eslint-config",
"overrides": [
+ {
+ "files": [
+ "src/main/resources/assets/*.js",
+ "src/main/resources/assets/*.ts"
+ ],
+ "extends": "@enonic/eslint-config/browser"
+ },
+ {
+ "files": [
+ "src/main/resources/lib/*.js",
+ "src/main/resources/lib/*.ts"
+ ],
+ "extends": "@enonic/eslint-config/xp"
+ },
{
"files": ["*.ts", "*.tsx"],
"parserOptions": {
"project": "./tsconfig.json"
}
}
]
}
Vanilla JavaScript
The default configuration will lint both TS and JS files. If your project doesn't use TypeScript, then @enonic/eslint-config/vanilla
configuration can be used instead. project
property must not be specified. No other TS-related peer dependencies must be installed either.
.eslintrc.json
{
- "extends": "@enonic/eslint-config",
+ "extends": "@enonic/eslint-config/vanilla",
"overrides": [
- {
- "files": ["*.ts", "*.tsx"],
- "parserOptions": {
- "project": "./tsconfig.json"
- }
- }
+ {
+ "files": ["src/main/resources/assets/*.js"],
+ "extends": "@enonic/eslint-config/browser"
+ },
+ {
+ "files": ["src/main/resources/lib/*.js"],
+ "extends": "@enonic/eslint-config/xp"
+ }
]
}
TypeScript
When using the TypeScript configuration instead of the default one, project
property must be moved to the parserOptions
under the config's root. This configuration should be prefered over the default one, if you lint TypeScript files only. It simplifies the configuration file a bit.
.eslintrc.json
{
- "extends": "@enonic/eslint-config",
+ "extends": "@enonic/eslint-config/typescript",
+ "parserOptions": {
+ "project": "./tsconfig.json"
+ }
"overrides": [
- {
- "files": ["*.ts", "*.tsx"],
- "parserOptions": {
- "project": "./tsconfig.json"
- }
- }
+ {
+ "files": ["src/main/resources/assets/*.ts"],
+ "extends": "@enonic/eslint-config/browser"
+ },
+ {
+ "files": ["src/main/resources/lib/*.ts"],
+ "extends": "@enonic/eslint-config/xp"
+ }
]
}