Giter VIP home page Giter VIP logo

eslint-plugin-node's Introduction

eslint-plugin-node

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-node
  • Requires Node.js >=6.0.0
  • Requires ESLint >=4.19.1 (plugin:node/recommended preset requires >=5.0.0)

Note: It recommends a use of the "engines" field of package.json. The "engines" field is used by node/no-unsupported-features/* rules.

.eslintrc.json (An example)

{
    "extends": ["eslint:recommended", "plugin:node/recommended"],
    "rules": {
        "node/exports-style": ["error", "module.exports"],
        "node/prefer-global/buffer": ["error", "always"],
        "node/prefer-global/console": ["error", "always"],
        "node/prefer-global/process": ["error", "always"],
        "node/prefer-global/url-search-params": ["error", "always"],
        "node/prefer-global/url": ["error", "always"]
    }
}

package.json (An example)

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

๐Ÿ“– Rules

  • โญ๏ธ - the mark of recommended rules.
  • โœ’๏ธ - the mark of fixable rules.

Possible Errors

Rule ID Description
node/no-extraneous-import disallow import declarations of extraneous packages
node/no-extraneous-require disallow require() expressions of extraneous packages โญ๏ธ
node/no-missing-import disallow import declarations of missing files
node/no-missing-require disallow require() expressions of missing files โญ๏ธ
node/no-unpublished-bin disallow 'bin' files which are ignored by npm โญ๏ธ
node/no-unpublished-import disallow import declarations of private things
node/no-unpublished-require disallow require() expressions of private things โญ๏ธ
node/no-unsupported-features/es-builtins disallow unsupported ECMAScript built-ins on the specified version โญ๏ธ
node/no-unsupported-features/es-syntax disallow unsupported ECMAScript syntax on the specified version โญ๏ธ
node/no-unsupported-features/node-builtins disallow unsupported Node.js built-in APIs on the specified version โญ๏ธ
node/process-exit-as-throw make process.exit() expressions the same code path as throw โญ๏ธ
node/shebang enforce the correct usage of shebang โญ๏ธโœ’๏ธ

Best Practices

Rule ID Description
node/no-deprecated-api disallow deprecated APIs โญ๏ธ

Stylistic Issues

Rule ID Description
node/exports-style enforce either module.exports or exports
node/prefer-global/buffer enforce either Buffer or require("buffer").Buffer
node/prefer-global/console enforce either console or require("console")
node/prefer-global/process enforce either process or require("process")
node/prefer-global/text-decoder enforce either TextDecoder or require("util").TextDecoder
node/prefer-global/text-encoder enforce either TextEncoder or require("util").TextEncoder
node/prefer-global/url-search-params enforce either URLSearchParams or require("url").URLSearchParams
node/prefer-global/url enforce either URL or require("url").URL

Deprecated rules

These rules have been deprecated in accordance with the deprecation policy, and replaced by newer rules:

Rule ID Replaced by
node/no-hide-core-modules (nothing)
node/no-unsupported-features node/no-unsupported-features/es-syntax and node/no-unsupported-features/es-builtins

๐Ÿ”ง Configs

This plugin provides plugin:node/recommended preset config. This preset config:

  • enables the environment of ES2015 (ES6) and Node.js.
  • enables rules which are given โญ in the above table.
  • enables no-process-exit rule because the official document does not recommend a use of process.exit().
  • adds {ecmaVersion: 2019} into parserOptions.
  • adds Atomics and SharedArrayBuffer into globals.
  • adds this plugin into plugins.

๐Ÿ‘ซ FAQ

๐Ÿšฅ Semantic Versioning Policy

eslint-plugin-node 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.

๐Ÿ“ฐ 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.

eslint-plugin-node's People

Contributors

mysticatea avatar aladdin-add avatar aprilarcus avatar zaubernerd avatar coreyfarrell avatar davej avatar feross avatar fabiopaiva avatar jackharrhy avatar platinumazure avatar arcanemagus avatar litomore avatar ybiquitous avatar fjandin avatar ronkorving avatar jokeyrhyme avatar rkaneko avatar sudo-suhas avatar not-an-aardvark avatar teppeis avatar chalker avatar

Watchers

James Cloos avatar Tom Modeste avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.