History

Cutls 25a1db84a4 Add: node_modules		2019-09-12 23:38:13 +09:00
..
api.js	Add: node_modules	2019-09-12 23:38:13 +09:00
index.js	Add: node_modules	2019-09-12 23:38:13 +09:00
license	Add: node_modules	2019-09-12 23:38:13 +09:00
package.json	Add: node_modules	2019-09-12 23:38:13 +09:00
readme.md	Add: node_modules	2019-09-12 23:38:13 +09:00
register.js	Add: node_modules	2019-09-12 23:38:13 +09:00

readme.md

loud-rejection

Make unhandled promise rejections fail loudly instead of the default silent fail

By default, promises fail silently if you don't attach a .catch() handler to them.

Use this in top-level things like tests, CLI tools, apps, etc, but not in reusable modules.

Not needed in the browser as unhandled promises are shown in the console.

Install

$ npm install --save loud-rejection

Usage

const loudRejection = require('loud-rejection');
const promiseFn = require('promise-fn');

// Install the unhandledRejection listeners
loudRejection();

promiseFn();

Without this module it's more verbose and you might even miss some that will fail silently:

const promiseFn = require('promise-fn');

function error(err) {
	console.error(err.stack);
	process.exit(1);
}

promiseFn().catch(error);

Register script

Alternatively to the above, you may simply require loud-rejection/register and the unhandledRejection listener will be automagically installed for you.

This is handy for ES2015 imports:

import 'loud-rejection/register';

API

loudRejection([log])

log

Type: Function

Default: console.error

Custom logging function to print the rejected promise. Receives the error stack.