NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #3530 most downloaded on npm
Enforce best practices for JavaScript promises
Last release 5 months ago
27 Apr 2026
Release timing varies
gaps range from 2 weeks to 1.6 years
Nearly every release is documented
notes for 47 of 49 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
50 releases · first in 2016
`no-promise-in-callback`: add exemptDeclarations option
no-promise-in-callback: add exemptDeclarations option (#513) (550524f)'use strict' directive (#593) (4cd7ea1)One column per quarter.
`no-callback-in-promise`: false triggering of callback
`no-callback-in-promise`: add timeoutsErr option
no-callback-in-promise: add timeoutsErr option (#514) (907753f)valid-params: add exclude option (#515) (7ff2cb9)ignoreAssignmentVariable option (#518) (701279c)allowThenStrict option (#522) (53be970)prefer-catch (#525) (05c8a93)`catch-or-return`, `prefer-await-to-then`: do not report Cypress commands
catch-or-return, prefer-await-to-then: do not report Cypress commands (#495) (943f162)prefer-await-to-then: ignore constructor scope unless with strict option (#496) (7bffb7a)spec-only to check for non-spec Promise methods (#502) (d6e9de1)feat!: Update node versions to align with eslint v9 (#505) (09d0650), closes #505 /github.com/eslint-community/eslint-plugin-promise/pull/484#issuecom
`always-return`: treat process.exit() or process.abort() as an acceptable "return"
remove name from eslintrc config; fixes #489
add name property to configs (for use with tooling)
# 6.4.0 (2024-07-01) ### Features * add support for flat config
# 6.3.0 (2024-07-01) ### Features * add support for eslint v9
no-callback-in-promise: false positives when the exception is an argument
no-multiple-resolved: false positives when the last expression in a try block is a call to resolve
always-return: false positives for logical expr
no-multiple-resolved rule (#369) (3a6fdbe)ignoreLastCallback option (#365) (01def31)Promise.allSettled() & Promise.any() (#370) (e080f82)resolvePattern & rejectPattern option (#368) (df25e3c)Fixed @typescript-eslint/parser issue #331, #205
Dropped node 10 from engines #231
Updated param-names rule to allow for unused params
param-names rule to allow for unused paramsUpdated docs to include no-callback-in-promise reasons #215
no-callback-in-promise reasons #215Included catch() and finally() in prefer-await-to-then #196
catch() and finally() in prefer-await-to-then #196- ESLint 7.0 Support
- Updated and applied prettier
https://github.com/eslint-community/eslint-plugin-promise/pull/202
Added more use cases to no-return-wrap
no-return-wrapNothing published for this version
Nothing published for this version
Remove promise/param-names fixer
promise/param-names fixer
(#146)This is a breaking change that drops support for Node v4. In order to use ESLint v5 and eslint-plugin-promise v4, you must use Node >=6.
Removed promise/avoid-new from recommended configuration
Added promise/valid-params rule
Added ['catch'] support in catch-or-return
['catch'] support in catch-or-returnno-return-in-finally ruleallowReject option to no-return-wrapno-callback-in-promiseAdded support for recommended settings using extends: plugin:promise/recommended
extends: plugin:promise/recommendedFixed always return false positive with ternary
- fixed #49
new rule: no-promise-in-callback
Nothing published for this version
- Removed eslint from peerDeps
Updated engines with proper stuff
Rule: prefer-async-to-callbacks added
prefer-async-to-callbacks addedprefer-async-to-then addedFix: no-return-wrap rule missing from index.js
no-return-wrap rule missing from index.js- Added no-return-wrap rule
no-return-wrap ruleAdded multiple terminationMethods
Updated column and line numbers
- Fixed type in docs
- ESLint 3.0 Support
Updated tests to run on eslint 2.0
no-native rule- Actually added no-native rule
no-native rule- Added no-native rule
no-native ruleAllow throw in always-return rule
throw in always-return ruleterminationMethod option to catch-or-return rule- Added catch-or-return rule
catch-or-return rule- Fixed crash issues
Lots of basic feature updates and doc changes
Your coding agent can read these notes before it upgrades. Set up the MCP server →