blob: c649d30c9adcee001c7db21b5bb2dcbcdf957b8a (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
|
---
title: AggregateError
slug: Web/JavaScript/Reference/Global_Objects/AggregateError
tags:
- AggregateError
- Classe
- Experimental
- Interface
- JavaScript
translation_of: Web/JavaScript/Reference/Global_Objects/AggregateError
original_slug: Web/JavaScript/Reference/Objets_globaux/AggregateError
---
{{JSRef}}
Un objet **`AggregateError`** représente une erreur lorsque plusieurs erreurs doivent être agrégées en une seule. Ce type d'exception est levée lorsque plusieurs erreurs sont rapportées par une opération, par exemple avec {{JSxRef("Promise.any()")}} lorsque l'ensemble des promesses qui lui sont passées échouent.
## Constructeur
- [`AggregateError()`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/AggregateError/AggregateError)
- : Crée un nouvel objet `AggregateError`.
## Propriétés des instances
- {{JSxRef("Error.prototype.message", "AggregateError.prototype.message")}}
- : Le message d'erreur. La valeur par défaut est `""`.
- {{JSxRef("Error.prototype.name", "AggregateError.prototype.name")}}
- : Le nom de l'erreur. La valeur par défaut est `"AggregateError"`.
## Exemples
### Intercepter une erreur `AggregateError`
```js
Promise.any([
Promise.reject(new Error("une erreur")),
]).catch(e => {
console.log(e instanceof AggregateError); // true
console.log(e.message); // "All Promises rejected"
console.log(e.name); // "AggregateError"
console.log(e.errors); // [ Error: "une erreur" ]
});
```
### Créer un objet `AggregateError`
```js
try {
throw new AggregateError([
new Error("une erreur"),
], 'Coucou');
} catch (e) {
console.log(e instanceof AggregateError); // true
console.log(e.message); // "Coucou"
console.log(e.name); // "AggregateError"
console.log(e.errors); // [ Error: "une erreur" ]
}
```
## Spécifications
| Spécification |
| -------------------------------------------------------------------------------------------------------------------- |
| {{SpecName('Promise.any', '#sec-aggregate-error-object-structure', 'AggregateError')}} |
## Compatibilité des navigateurs
{{Compat("javascript.builtins.AggregateError")}}
## Voir
- {{JSxRef("Error")}}
|