# loud-rejection [](https://travis-ci.org/sindresorhus/loud-rejection) [](https://coveralls.io/github/sindresorhus/loud-rejection?branch=master) > Make unhandled promise rejections fail loudly instead of the default [silent fail](https://gist.github.com/benjamingr/0237932cee84712951a2) 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.**<br> Not needed in the browser as unhandled promises are shown in the console. ## Install ``` $ npm install --save loud-rejection ``` ## Usage ```js 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: ```js 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: ```js import 'loud-rejection/register'; ``` ## API ### loudRejection([log]) #### log Type: `Function`<br> Default: `console.error` Custom logging function to print the rejected promise. Receives the error stack. ## License MIT © [Sindre Sorhus](https://sindresorhus.com)