16.6.2 • Published 3 days ago

eslint-plugin-n v16.6.2

Weekly downloads
-
License
MIT
Repository
github
Last release
3 days ago

eslint-plugin-n

forked from eslint-plugin-node v11.1.0. as the original repository seems no longer maintained.

npm version Downloads/month Build Status Coverage Status Dependency Status

Additional ESLint's rules for Node.js

💿 Install & Usage

npm install --save-dev eslint eslint-plugin-n
  • Requires Node.js >=16.0.0
  • Requires ESLint >=7.0.0

.eslintrc.json (An example)

{
    "extends": ["eslint:recommended", "plugin:n/recommended"],
    "parserOptions": {
        "ecmaVersion": 2021
    },
    "rules": {
        "n/exports-style": ["error", "module.exports"],
        "n/file-extension-in-import": ["error", "always"],
        "n/prefer-global/buffer": ["error", "always"],
        "n/prefer-global/console": ["error", "always"],
        "n/prefer-global/process": ["error", "always"],
        "n/prefer-global/url-search-params": ["error", "always"],
        "n/prefer-global/url": ["error", "always"],
        "n/prefer-promises/dns": "error",
        "n/prefer-promises/fs": "error"
    }
}

package.json (An example)

{
    "name": "your-module",
    "version": "1.0.0",
    "type": "commonjs",
    "engines": {
        "node": ">=8.10.0"
    }
}

Configured Node.js version range

The rules get the supported Node.js version range from the following, falling back to the next if unspecified:

  1. Rule configuration version
  2. ESLint shared setting node.version
  3. package.json engines field
  4. >=16.0.0

If you omit the engines field, this rule chooses >=16.0.0 as the configured Node.js version since 16 is the maintained lts (see also Node.js Release Working Group).

For Node.js packages, using the engines field is recommended because it's the official way to indicate support:

{
    "name": "your-module",
    "version": "1.0.0",
    "engines": {
        "node": ">=16.0.0"
    }
}

For Shareable Configs or packages with a different development environment (e.g. pre-compiled, web package, etc.), you can configure ESLint with settings.node.version to specify support.

📖 Rules

💼 Configurations enabled in.\ ✅ Set in the recommended configuration.\ 🔧 Automatically fixable by the --fix CLI option.\ ❌ Deprecated.

Best Practices

NameDescription💼🔧
no-deprecated-apidisallow deprecated APIs

Possible Errors

Name                                 Description💼🔧
handle-callback-errrequire error handling in callbacks
no-callback-literalenforce Node.js-style error-first callback pattern is followed
no-exports-assigndisallow the assignment to exports
no-extraneous-importdisallow import declarations which import extraneous modules
no-extraneous-requiredisallow require() expressions which import extraneous modules
no-hide-core-modulesdisallow third-party modules which are hiding core modules
no-missing-importdisallow import declarations which import non-existence modules
no-missing-requiredisallow require() expressions which import non-existence modules
no-new-requiredisallow new operators with calls to require
no-path-concatdisallow string concatenation with __dirname and __filename
no-process-exitdisallow the use of process.exit()
no-unpublished-bindisallow bin files that npm ignores
no-unpublished-importdisallow import declarations which import private modules
no-unpublished-requiredisallow require() expressions which import private modules
no-unsupported-featuresdisallow unsupported ECMAScript features on the specified version
no-unsupported-features/es-builtinsdisallow unsupported ECMAScript built-ins on the specified version
no-unsupported-features/es-syntaxdisallow unsupported ECMAScript syntax on the specified version
no-unsupported-features/node-builtinsdisallow unsupported Node.js built-in APIs on the specified version
process-exit-as-throwrequire that process.exit() expressions use the same code path as throw
shebangrequire correct usage of shebang🔧

Stylistic Issues

Name                           Description💼🔧
callback-returnrequire return statements after callbacks
exports-styleenforce either module.exports or exports🔧
file-extension-in-importenforce the style of file extensions in import declarations🔧
global-requirerequire require() calls to be placed at top-level module scope
no-mixed-requiresdisallow require calls to be mixed with regular variable declarations
no-process-envdisallow the use of process.env
no-restricted-importdisallow specified modules when loaded by import declarations
no-restricted-requiredisallow specified modules when loaded by require
no-syncdisallow synchronous methods
prefer-global/bufferenforce either Buffer or require("buffer").Buffer
prefer-global/consoleenforce either console or require("console")
prefer-global/processenforce either process or require("process")
prefer-global/text-decoderenforce either TextDecoder or require("util").TextDecoder
prefer-global/text-encoderenforce either TextEncoder or require("util").TextEncoder
prefer-global/urlenforce either URL or require("url").URL
prefer-global/url-search-paramsenforce either URLSearchParams or require("url").URLSearchParams
prefer-promises/dnsenforce require("dns").promises
prefer-promises/fsenforce require("fs").promises

🔧 Configs

This plugin provides three configs:

NameDescription
plugin:n/recommendedConsiders both CommonJS and ES Modules. If "type":"module" field existed in package.json then it considers files as ES Modules. Otherwise it considers files as CommonJS. In addition, it considers *.mjs files as ES Modules and *.cjs files as CommonJS.
plugin:n/recommended-moduleConsiders all files as ES Modules.
plugin:n/recommended-scriptConsiders all files as CommonJS.

These preset configs:

  • enable no-process-exit rule because the official document does not recommend a use of process.exit().
  • enable plugin rules which are given ✅ in the above table.
  • add {ecmaVersion: 2021} and etc into parserOptions.
  • add proper globals into globals.
  • add this plugin into plugins.

👫 FAQ

🚥 Semantic Versioning Policy

eslint-plugin-n follows semantic versioning and ESLint's Semantic Versioning Policy.

  • Patch release (intended to not break your lint build)
    • A bug fix in a rule that results in it reporting fewer errors.
    • Improvements to documentation.
    • Non-user-facing changes such as refactoring code, adding, deleting, or modifying tests, and increasing test coverage.
    • Re-releasing after a failed release (i.e., publishing a release that doesn't work for anyone).
  • Minor release (might break your lint build)
    • A bug fix in a rule that results in it reporting more errors.
    • A new rule is created.
    • A new option to an existing rule is created.
    • An existing rule is deprecated.
  • Major release (likely to break your lint build)
    • A support for old Node version is dropped.
    • A support for old ESLint version is dropped.
    • An existing rule is changed in it reporting more errors.
    • An existing rule is removed.
    • An existing option of a rule is removed.
    • An existing config is updated.

Deprecated rules follow ESLint's deprecation policy.

📰 Changelog

❤️ Contributing

Welcome contributing!

Please use GitHub's Issues/PRs.

Development Tools

  • npm test runs tests and measures coverage.
  • npm run coverage shows the coverage result of npm test command.
  • npm run clean removes the coverage result of npm test command.
@yysmx/eslint-config@yysmx/eslint-config-basic@anjun-brasil/eslint-configwmc-eslint@azul-tecnologia/eslint-config@lvyunlong/eslint-config@lvyunlong/eslint-config-basic@minozzzi/eslint-config@jiqi/eslint-config@jiqi/eslint-config-basic@jiralite/eslint-config-neon@kaivanwong/eslint-config-base@qualopreco/eslint-config@rjqh/eslint-config-basic@rain-star/eslint-config-basic@polkadot/dev@cyenoch/eslint-config@asasinmode/eslint-config@obvcloud/eslint-config-preset-basic@denverzh/eslint-config@denverzh/eslint-config-base@ventjs/eslint-config-basic@ixfe/eslint-config-basic@silence94/eslint-config-basic@jady/eslint-config@caryhu/eslint-config-basiceslint-config-asteroid-preview@fellwork/eslint-config-core@fellwork/eslint-config-foreman@easy-going/eslint-config-base@renya/eslint-config-core@progressivestudio/eslint-config-base@chris-zhu/eslint-config-basiceslint-config-zggz@liuhq8796/eslint-config-wonderful-elementeslint-config-tiggertest@infinitebrahmanuniverse/nolb-eslint-plugin-n@mafalda/eslint-config@yomarsanchez/eslint-config-seek@kriszu/eslint-config-basic@liberopneto/eslint-config@soybeanjs/eslint-config-basic@darkmatter-ui/eslint-config@godismyjudgebro/eslint-config@asasinmode/eslint-config-basic@tgarif/eslint-config-basiceslint-config-soybeanjs-base@kayooliveira/eslint-config@kayooliveira/eslint-plugin@stackz/eslint-configeslint-config-dienerld-reactdienerld-eslint-reactlucasaugustscode-eslint-configeslint-config-mynaeslint-config-watchfulla-eslint-configeslint-config-flowersolid-ui@tackpay/eslint-config-ts@okno/eslint-configquickestrainklinglog@everything-registry/sub-chunk-1612@alt-research/dev@amadeulinhares/eslint-config@ifmini/eslint-config@ifshizuku/eslint-config-basic@ventsislavnikolov/eslint-config@ifmini/eslint-config-core@alexmadeira/config-eslint@alexmadeira/eslint-config-testealiksend-lintervbg_eslinteslint-config-zohynorylord-kitnorylord-ui-kit@wood-scripts/eslint-config@daopk/eslint-config-nodeeslint-config-vbg@verteal/eslint-configeslint-config-lucasspradostitch-node@geektech/eslint-pluginkajiyamavk-eslint-configlinter-bundlehubees-eslintko-lint-configgoogler-jsgrulesgreat-harmonyisaacscript-lintjohnsonav-eslint-configniise-common-componentsniise-common-modulesnico-test-dsnode-bump-versionmr-eslint-lintly-lintlx-utils-demo@sergeyzwezdin/eslint-config
17.0.0-6

3 days ago

17.0.0-5

9 days ago

17.0.0-4

22 days ago

17.0.0-3

1 month ago

17.0.0-2

1 month ago

17.0.0-1

2 months ago

16.6.2

3 months ago

17.0.0-0

3 months ago

16.6.1

3 months ago

16.6.0

3 months ago

16.5.0

3 months ago

16.4.0

4 months ago

16.3.1

5 months ago

16.3.0

5 months ago

16.2.0

6 months ago

16.1.0

7 months ago

16.0.2

7 months ago

16.0.1

9 months ago

16.0.0

11 months ago

16.0.0-0

11 months ago

16.0.0-1

11 months ago

15.7.0

1 year ago

15.6.1

1 year ago

15.5.0

1 year ago

15.4.0

1 year ago

15.5.2

1 year ago

15.6.0

1 year ago

15.5.1

1 year ago

15.3.0

2 years ago

15.2.5

2 years ago

15.2.1

2 years ago

15.2.4

2 years ago

15.2.2

2 years ago

15.2.3

2 years ago

15.2.0

2 years ago

15.1.0

2 years ago

15.0.1

2 years ago

15.0.0

2 years ago

14.0.0

2 years ago