aboutsummaryrefslogtreecommitdiff
path: root/files/es/web/javascript/reference/global_objects/aggregateerror/index.html
blob: 35d70202d14395be3a203c1de333135f511f8a03 (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
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
---
title: AggregateError
slug: Web/JavaScript/Reference/Global_Objects/AggregateError
tags:
  - AggregateError
  - Clase
  - Experimental
  - Interfaz
  - JavaScript
translation_of: Web/JavaScript/Reference/Global_Objects/AggregateError
original_slug: Web/JavaScript/Referencia/Objetos_globales/AggregateError
---
<div>{{JSRef}}</div>

<p>El objeto <code><strong>AggregateError</strong></code> representa un error cuando se deben agrupar varios errores en un solo error. Se lanza cuando una operación necesita informar de varios errores, por ejemplo, {{JSxRef("Promise.any()")}}, cuando todas las promesas que se le pasan son rechazadas.</p>

<h2 id="Constructor">Constructor</h2>

<dl>
 <dt>{{JSxRef("Global_Objects/AggregateError/AggregateError", "AggregateError()")}}</dt>
 <dd>Crea un nuevo objeto <code>AggregateError</code>.</dd>
</dl>

<h2 id="Propiedades_de_la_instancia">Propiedades de la instancia</h2>

<dl>
 <dt>{{JSxRef("Error.prototype.message", "AggregateError.prototype.message")}}</dt>
 <dd>Mensaje de error, el valor predeterminado es <code>""</code> (la cadena vacía).</dd>
 <dt>{{JSxRef("Error.prototype.name", "AggregateError.prototype.name")}}</dt>
 <dd>Nombre del error, el valor predeterminado es <code>AggregateError</code>.</dd>
</dl>

<h2 id="Ejemplos">Ejemplos</h2>

<h3 id="Capturar_un_error_agregado">Capturar un error agregado</h3>

<pre class="brush: js; notranslate">Promise.any([
  Promise.reject(new Error("algún error")),
]).catch(e =&gt; {
  console.log(e instanceof AggregateError); // true
  console.log(e.message);                   // "Todas las promesas rechazadas"
  console.log(e.name);                      // "AggregateError"
  console.log(e.errors);                    // [ Error: "algún error" ]
});
</pre>

<h3 id="Crear_un_AggregateError">Crear un <code>AggregateError</code></h3>

<pre class="brush: js; notranslate">try {
  throw new AggregateError([
    new Error("algún error"),
  ], 'Hola');
} catch (e) {
  console.log(e instanceof AggregateError); // true
  console.log(e.message);                   // "Hola"
  console.log(e.name);                      // "AggregateError"
  console.log(e.errors);                    // [ Error: "algún error" ]
}
</pre>

<h2 id="Especificaciones">Especificaciones</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Especificación</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('Promise.any', '#sec-aggregate-error-objects', 'AggregateError')}}</td>
  </tr>
 </tbody>
</table>

<h2 id="Compatibilidad_del_navegador">Compatibilidad del navegador</h2>

<div>


<p>{{Compat("javascript.builtins.AggregateError")}}</p>
</div>

<h2 id="Ve_también">Ve también</h2>

<ul>
 <li>{{JSxRef("Error")}}</li>
</ul>