You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
61 lines
1.8 KiB
61 lines
1.8 KiB
# aggregate-error [![Build Status](https://travis-ci.org/sindresorhus/aggregate-error.svg?branch=master)](https://travis-ci.org/sindresorhus/aggregate-error) |
|
|
|
> Create an error from multiple errors |
|
|
|
|
|
## Install |
|
|
|
``` |
|
$ npm install aggregate-error |
|
``` |
|
|
|
|
|
## Usage |
|
|
|
```js |
|
const AggregateError = require('aggregate-error'); |
|
|
|
const error = new AggregateError([new Error('foo'), 'bar', {message: 'baz'}]); |
|
|
|
throw error; |
|
/* |
|
AggregateError: |
|
Error: foo |
|
at Object.<anonymous> (/Users/sindresorhus/dev/aggregate-error/example.js:3:33) |
|
Error: bar |
|
at Object.<anonymous> (/Users/sindresorhus/dev/aggregate-error/example.js:3:13) |
|
Error: baz |
|
at Object.<anonymous> (/Users/sindresorhus/dev/aggregate-error/example.js:3:13) |
|
at AggregateError (/Users/sindresorhus/dev/aggregate-error/index.js:19:3) |
|
at Object.<anonymous> (/Users/sindresorhus/dev/aggregate-error/example.js:3:13) |
|
at Module._compile (module.js:556:32) |
|
at Object.Module._extensions..js (module.js:565:10) |
|
at Module.load (module.js:473:32) |
|
at tryModuleLoad (module.js:432:12) |
|
at Function.Module._load (module.js:424:3) |
|
at Module.runMain (module.js:590:10) |
|
at run (bootstrap_node.js:394:7) |
|
at startup (bootstrap_node.js:149:9) |
|
*/ |
|
|
|
for (const individualError of error) { |
|
console.log(individualError); |
|
} |
|
//=> [Error: foo] |
|
//=> [Error: bar] |
|
//=> [Error: baz] |
|
``` |
|
|
|
|
|
## API |
|
|
|
### AggregateError(errors) |
|
|
|
Returns an `Error` that is also an [`Iterable`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Iterators_and_Generators#Iterables) for the individual errors. |
|
|
|
#### errors |
|
|
|
Type: `Array<Error|Object|string>` |
|
|
|
If a string, a new `Error` is created with the string as the error message.<br> |
|
If a non-Error object, a new `Error` is created with all properties from the object copied over.
|
|
|