mirror of
https://github.com/S2-/gitlit
synced 2025-08-04 13:10:09 +02:00
add node modules to repo
This commit is contained in:
68
node_modules/loud-rejection/readme.md
generated
vendored
Normal file
68
node_modules/loud-rejection/readme.md
generated
vendored
Normal file
@@ -0,0 +1,68 @@
|
||||
# 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)
|
Reference in New Issue
Block a user