modyqyw / eslint

ESLint module for Nuxt.js

@nuxtjs/eslint-module

ESLint module for Nuxt

📖 Release Notes

---

Note: This branch is for Nuxt 3 or Nuxt Bridge compatible module. Checkout the nuxt2 branch for Nuxt 2 support.

---

Requirements

You need to ensure that you have eslint >= 7 installed:

With pnpm

pnpm add -D eslint

Or, with yarn

yarn add -D eslint

Or, with npm

npm install -D eslint

Setup

1. Add @nuxtjs/eslint-module dependency to your project

With pnpm

pnpm add -D @nuxtjs/eslint-module

Or, with yarn

yarn add -D @nuxtjs/eslint-module

Or, with npm

npm install -D @nuxtjs/eslint-module

2. Add @nuxtjs/eslint-module to the modules section of nuxt.config.ts

export default defineNuxtConfig({
  modules: [
    // Simple usage
    '@nuxtjs/eslint-module',

    // With options
    ['@nuxtjs/eslint-module', { /* module options */ }]
  ]
})

Using top level options

export default defineNuxtConfig({
  modules: [
    '@nuxtjs/eslint-module'
  ],
  eslint: {
    /* module options */
  }
})

Options

You can pass eslint options.

Note that the config option you provide will be passed to the ESLint class. This is a different set of options than what you'd specify in package.json or .eslintrc. See the eslint docs for more details.

cache

• Type: Boolean
• Default: true

Note: The cache is enabled by default to decrease execution time.

include

• Type: String|Array[String]
• Default: [nuxt.options.srcDir.'/**/*.{js,jsx,ts,tsx,vue}']

Specify directories, files, or globs.

exclude

• Type: Array[String]
• Default: ['**/node_modules/**', nuxt.options.buildDir]

Specify the files and/or directories to exclude.

eslintPath

• Type: String
• Default: eslint

Path to eslint instance that will be used for linting. Set 'eslint/use-at-your-own-risk' if you want to use the flat config system in ESLint v8. Place an eslint.config.js file in the root of your project or set the ESLINT_USE_FLAT_CONFIG environment variable to true and pass the option overrideConfigFile to the plugin if you are using other config files. You can learn more from Flat config rollout plans and Configuration Files (New).

formatter

• Type: String|Function
• Default: 'stylish'

Accepts a function that will have one argument: an array of eslint messages (object). The function must return the output as a string. You can use official eslint formatters.

lintOnStart

• Type: Boolean
• Default: true

Check all matching files on project startup, too slow, turn on discreetly.

emitWarning

• Type: Boolean
• Default: true

The warnings found will be printed.

emitError

• Type: Boolean
• Default: true

The errors found will be printed.

failOnWarning

• Type: Boolean
• Default: false

Will cause the module build to fail if there are any warnings, based on emitWarning.

failOnError

• Type: Boolean
• Default: false

Will cause the module build to fail if there are any errors, based on emitError.

Contributing

You can contribute to this module online with CodeSandBox:

Or locally:

1. Clone this repository
2. Install dependencies using pnpm install
3. Prepare development server using pnpm dev:prepare
4. Build module using pnpm build
5. Launch playground using pnpm dev

License

MIT License

Copyright (c) Nuxt Community