Surfaces unhandled promise rejections in jest tests.

Downloads in past


1.0.06 years ago6 years agoMinified + gzip package size for jest-unhandled-promise in KB


npm npm npm CircleCI branch
Surfaces unhandled promise rejections in jest tests.

Getting Started

Install jest-unhandled-promise using yarn:
yarn add --dev jest-unhandled-promise


Currently, when running tests in jest, if you have an unhandled promise rejection, you'll see this warning:
(node:23112) UnhandledPromiseRejectionWarning: Unhandled promise rejection (rejection id: 1): Error: unhandled error
(node:23112) [DEP0018] DeprecationWarning: Unhandled promise rejections are deprecated. In the future, promise rejections that are not handled will terminate the Node.js process with a non-zero exit code.

Your tests may or may not pass, and you might miss this error.
With jest-unhandled-promise, you'll see this nice, red stack trace in your console:
Error: unhandled error
  at /Users/mark/projects/negativetwelve/jest-unhandled-promise/src/__tests__/install.spec.js:9:61
  at Promise (<anonymous>)
  at /Users/mark/projects/negativetwelve/jest-unhandled-promise/src/__tests__/install.spec.js:9:7
  at Promise (<anonymous>)
  at /Users/mark/projects/negativetwelve/jest-unhandled-promise/src/__tests__/install.spec.js:7:56
  at _callee4$ (/Users/mark/projects/negativetwelve/jest-unhandled-promise/src/__tests__/install.spec.js:59:17)
  at tryCatch (/Users/mark/projects/negativetwelve/jest-unhandled-promise/node_modules/regenerator-runtime/runtime.js:65:40)
  at Generator.invoke [as _invoke] (/Users/mark/projects/negativetwelve/jest-unhandled-promise/node_modules/regenerator-runtime/runtime.js:303:22)
  at Generator.prototype.(anonymous function) [as next] (/Users/mark/projects/negativetwelve/jest-unhandled-promise/node_modules/regenerator-runtime/runtime.js:117:21)
  at step (/Users/mark/projects/negativetwelve/jest-unhandled-promise/src/__tests__/install.spec.js:2:364)

Now you can easily handle errors and fix up your specs!


If you want, you can import installUnhandledPromise from jest-unhandled-promise at the top of every test:
import installUnhandledPromise from 'jest-unhandled-promise';

// Pass in your custom log function.

If you want to install it as a global for all tests, you can modify the jest section of your package.json to include:
"jest": {
  "setupFiles": [


If you have any ideas on how this module could be better, create an Issue or submit a PR.