eslint-plugin-promise

Enforce best practices for JavaScript promises

ISC 50 个版本
eslint eslintplugin eslint-plugin promise promises
主页
仓库
提交 Issue
安装
npm install eslint-plugin-promise
yarn add eslint-plugin-promise
pnpm add eslint-plugin-promise
bun add eslint-plugin-promise
README

eslint-plugin-promise

Enforce best practices for JavaScript promises.

CI npm version

Installation

You'll first need to install ESLint:

npm install eslint --save-dev

Next, install eslint-plugin-promise:

npm install eslint-plugin-promise --save-dev

Note: If you installed ESLint globally (using the -g flag) then you must also install eslint-plugin-promise globally.

Usage

Add promise to the plugins section of your .eslintrc.json configuration file. You can omit the eslint-plugin- prefix:

{
  "plugins": ["promise"]
}

Then configure the rules you want to use under the rules section.

{
  "rules": {
    "promise/always-return": "error",
    "promise/no-return-wrap": "error",
    "promise/param-names": "error",
    "promise/catch-or-return": "error",
    "promise/no-native": "off",
    "promise/no-nesting": "warn",
    "promise/no-promise-in-callback": "warn",
    "promise/no-callback-in-promise": "warn",
    "promise/avoid-new": "warn",
    "promise/no-new-statics": "error",
    "promise/no-return-in-finally": "warn",
    "promise/valid-params": "warn",
    "promise/no-multiple-resolved": "error"
  }
}

or start with the recommended rule set:

  • eslint.config.js:

    import pluginPromise from 'eslint-plugin-promise'
export default [
  // ...
  pluginPromise.configs['flat/recommended'],
]

  • .eslintrc.*:

    {
  "extends": ["plugin:promise/recommended"]
}

Rules

💼 Configurations enabled in.
⚠️ Configurations set to warn in.
🚫 Configurations disabled in.
✅ Set in the flat/recommended configuration.
✅ Set in the recommended configuration.
🔧 Automatically fixable by the --fix CLI option.

Name                      Description 💼 ⚠️ 🚫 🔧
always-return Require returning inside each then() to create readable and reusable Promise chains. ✅
avoid-new Disallow creating new promises outside of utility libs (use util.promisify instead). ✅
catch-or-return Enforce the use of catch() on un-returned promises. ✅
no-callback-in-promise Disallow calling cb() inside of a then() (use util.callbackify instead). ✅
no-multiple-resolved Disallow creating new promises with paths that resolve multiple times.
no-native Require creating a Promise constructor before using it in an ES5 environment. ✅
no-nesting Disallow nested then() or catch() statements. ✅
no-new-statics Disallow calling new on a Promise static method. ✅ 🔧
no-promise-in-callback Disallow using promises inside of callbacks. ✅
no-return-in-finally Disallow return statements in finally(). ✅
no-return-wrap Disallow wrapping values in Promise.resolve or Promise.reject when not needed. ✅
param-names Enforce consistent param names and ordering when creating new promises. ✅
prefer-await-to-callbacks Prefer async/await to the callback pattern.
prefer-await-to-then Prefer await to then()/catch()/finally() for reading Promise values.
prefer-catch Prefer catch to then(a, b)/then(null, b) for handling errors. 🔧
spec-only Disallow use of non-standard Promise static methods.
valid-params Enforces the proper number of arguments are passed to Promise functions. ✅

Maintainers

License

版本列表
7.3.0 2026-04-27
7.2.1 2024-11-27
7.2.0 2024-11-25
7.1.0 2024-08-06
7.0.0 2024-07-24
6.6.0 2024-07-21
6.5.1 2024-07-20
6.5.0 2024-07-19
6.4.0 2024-07-01
6.3.0 2024-07-01
6.2.0 2024-05-27
6.1.1 2022-10-19
6.1.0 2022-10-13
6.0.1 2022-08-25
6.0.0 2021-12-18
5.2.0 2021-12-01
5.1.1 2021-10-21
5.1.0 2021-04-09
5.0.0 2021-04-09
4.3.1 2021-02-10
4.3.0 2021-02-10
4.2.1 2019-06-25
4.1.1 2019-04-01
4.1.0 2019-04-01
4.0.1 2018-09-07
4.0.0 2018-08-17
3.8.0 2018-05-24
3.7.0 2018-03-08
3.6.0 2017-10-13
3.5.0 2017-02-28
3.4.2 2017-02-17
3.4.1 2017-02-06
3.4.0-0 2016-11-17
3.4.0 2016-11-17
3.3.2 2016-11-11
3.3.1 2016-11-04
3.3.0 2016-10-18
3.2.1 2016-10-18
3.2.0 2016-10-18
3.1.0 2016-10-18
3.0.0 2016-10-07
2.0.1 2016-08-05
2.0.0 2016-07-13
1.3.2 2016-06-03
1.3.1 2016-05-27
1.3.0 2016-05-25
1.2.0 2016-05-25
1.1.0 2016-03-02
1.0.8 2016-02-06
1.0.0 2016-01-22