# @nuxtjs/eslint-module

> ESLint module for Nuxt

Latest version **4.1.0** (published 2023-05-18) · MIT license · 0 weekly downloads

## Install

```sh
npm install @nuxtjs/eslint-module
pnpm add @nuxtjs/eslint-module
yarn add @nuxtjs/eslint-module
bun add @nuxtjs/eslint-module
```

## Health

**Score 45/100 (D)** — status: abandoned.

Positive: has types; esm support; no vulnerabilities; high maintenance score; high quality score.

Warnings: low downloads.

Negative: abandoned.

## Facts

| | |
|---|---|
| Version | 4.1.0 |
| Published | 2023-05-18 |
| First published | 2019-02-12 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 5 |
| Unpacked size | 10.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 168 |
| Maintainers | ricardogobbosouza, antfu, mannil, pi0, kevinmarrec, clarkdo, atinux |

## Links

- npm: https://www.npmjs.com/package/@nuxtjs/eslint-module
- Repository: https://github.com/nuxt-community/eslint-module
- Homepage: https://github.com/nuxt-community/eslint-module#readme
- Issues: https://github.com/nuxt-community/eslint-module/issues
- npm.io page: https://npm.io/package/@nuxtjs/eslint-module

## Dependencies (5)

- [pathe](https://npm.io/package/pathe.md) ^1.1.0
- [chokidar](https://npm.io/package/chokidar.md) ^3.5.3
- [@nuxt/kit](https://npm.io/package/@nuxt/kit.md) ^3.5.0
- [vite-plugin-eslint](https://npm.io/package/vite-plugin-eslint.md) ^1.8.1
- [eslint-webpack-plugin](https://npm.io/package/eslint-webpack-plugin.md) ^4.0.1

## Recent versions

- 4.1.0 (latest) — 2023-05-18
- 3.1.0 (nuxt2) — 2022-04-08
- 4.0.2 — 2023-03-10
- 4.0.1 — 2023-03-08
- 4.0.0 — 2023-03-08
- 3.0.2 — 2020-12-16
- 3.0.1 — 2020-11-13
- 3.0.0 — 2020-10-07
- 2.0.0 — 2020-05-05
- 1.2.0 — 2020-04-24
- 1.1.0 — 2019-09-13
- 1.0.0 — 2019-07-26
- 0.2.1 — 2019-07-01
- 0.2.0 — 2019-06-27
- 0.1.0 — 2019-06-27
- … 1 more at https://npm.io/package/@nuxtjs/eslint-module/versions

## README

# @nuxtjs/eslint-module

[![npm version][npm-version-src]][npm-version-href]
[![npm downloads][npm-downloads-src]][npm-downloads-href]
[![Github Actions CI][github-actions-ci-src]][github-actions-ci-href]
[![Codecov][codecov-src]][codecov-href]
[![License][license-src]][license-href]

> ESLint module for Nuxt

[📖 **Release Notes**](./CHANGELOG.md)

---

**Note:** This branch is for **Nuxt 3** or **Nuxt Bridge** compatible module.
Checkout the [`nuxt2` branch](https://github.com/nuxt-community/eslint-module/tree/nuxt2) for **Nuxt 2** support.

---

## Requirements

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

With `pnpm`

```bash
pnpm add -D eslint
```

Or, with `yarn`

```bash
yarn add -D eslint
```

Or, with `npm`

```bash
npm install -D eslint
```

## Setup

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

With `pnpm`

```bash
pnpm add -D @nuxtjs/eslint-module
```

Or, with `yarn`

```bash
yarn add -D @nuxtjs/eslint-module
```

Or, with `npm`

```bash
npm install -D @nuxtjs/eslint-module
```

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

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

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

### Using top level options

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

## Options

You can pass [eslint options](https://eslint.org/docs/latest/integrate/nodejs-api#-new-eslintoptions).

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](https://eslint.org/docs/latest/integrate/nodejs-api#-new-eslintoptions) 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.

### `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](https://eslint.org/docs/user-guide/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:

[![Edit @nuxtjs/robots](https://codesandbox.io/static/img/play-codesandbox.svg)](https://codesandbox.io/s/github/nuxt-community/eslint-module/?fontsize=14&hidenavigation=1&theme=dark)

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](./LICENSE)

Copyright (c) Nuxt Community

<!-- Badges -->
[npm-version-src]: https://img.shields.io/npm/v/@nuxtjs/eslint-module/latest.svg
[npm-version-href]: https://npmjs.com/package/@nuxtjs/eslint-module

[npm-downloads-src]: https://img.shields.io/npm/dt/@nuxtjs/eslint-module.svg
[npm-downloads-href]: https://npmjs.com/package/@nuxtjs/eslint-module

[github-actions-ci-src]: https://github.com/nuxt-community/eslint-module/workflows/ci/badge.svg
[github-actions-ci-href]: https://github.com/nuxt-community/eslint-module/actions?query=workflow%3Aci

[codecov-src]: https://img.shields.io/codecov/c/github/nuxt-community/eslint-module.svg
[codecov-href]: https://codecov.io/gh/nuxt-community/eslint-module

[license-src]: https://img.shields.io/npm/l/@nuxtjs/eslint-module.svg
[license-href]: https://npmjs.com/package/@nuxtjs/eslint-module

---
_Source: https://npm.io/package/@nuxtjs/eslint-module · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._