loud-rejection

WebJar for loud-rejection

License

License

MIT
GroupId

GroupId

org.webjars.npm
ArtifactId

ArtifactId

loud-rejection
Last Version

Last Version

1.6.0
Release Date

Release Date

Type

Type

jar
Description

Description

loud-rejection
WebJar for loud-rejection
Project URL

Project URL

http://webjars.org
Source Code Management

Source Code Management

https://github.com/sindresorhus/loud-rejection

Download loud-rejection

How to add to project

<!-- https://jarcasting.com/artifacts/org.webjars.npm/loud-rejection/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>loud-rejection</artifactId>
    <version>1.6.0</version>
</dependency>
// https://jarcasting.com/artifacts/org.webjars.npm/loud-rejection/
implementation 'org.webjars.npm:loud-rejection:1.6.0'
// https://jarcasting.com/artifacts/org.webjars.npm/loud-rejection/
implementation ("org.webjars.npm:loud-rejection:1.6.0")
'org.webjars.npm:loud-rejection:jar:1.6.0'
<dependency org="org.webjars.npm" name="loud-rejection" rev="1.6.0">
  <artifact name="loud-rejection" type="jar" />
</dependency>
@Grapes(
@Grab(group='org.webjars.npm', module='loud-rejection', version='1.6.0')
)
libraryDependencies += "org.webjars.npm" % "loud-rejection" % "1.6.0"
[org.webjars.npm/loud-rejection "1.6.0"]

Dependencies

compile (2)

Group / Artifact Type Version
org.webjars.npm : currently-unhandled jar [0.4.1,0.5)
org.webjars.npm : signal-exit jar [3.0.0,4)

Project Modules

There are no modules declared in this project.

loud-rejection Build Status Coverage Status

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.

This tool keeps track of unhandled rejections globally. If any remain unhandled at the end of your process, it logs them to STDERR and exits with code 1.

Use this in top-level things like tests, CLI tools, apps, etc, but not in reusable modules.
Not needed in the browser as unhandled rejections are shown in the console.

With Node.js 15, this package is moot as the default behavior then is to throw on unhandled rejections.

Install

$ npm install loud-rejection

Usage

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

// Install the `unhandledRejection` listeners
loudRejection();

promiseFunction();

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

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

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

promiseFunction().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.

Related

  • hard-rejection - Make unhandled promise rejections fail hard right away instead of the default silent fail
  • More…

Get professional support for this package with a Tidelift subscription
Tidelift helps make open source sustainable for maintainers while giving companies
assurances about security, maintenance, and licensing for their dependencies.

Versions

Version
1.6.0
1.4.1