aboutsummaryrefslogtreecommitdiff
path: root/files/es/web/javascript/reference/operators/async_function/index.html
blob: 12e76e6ce566a1a0d080d141f1256d1089ab8f7a (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
89
90
91
92
93
94
95
96
97
98
99
100
101
102
---
title: Expresión de función asíncrona
slug: Web/JavaScript/Referencia/Operadores/async_function
tags:
  - Expresión Primaria
  - JavaScript
  - Operador
  - función
translation_of: Web/JavaScript/Reference/Operators/async_function
---
<div>{{jsSidebar("Operators")}}</div>

<p>La palabra clave <strong><code>async function</code></strong> puede ser utilizada para definir funciones <code>async</code> dento de expresiones.</p>

<p>También se pueden definir funciones asíncronas utilizando un<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/async_function" title="The async function keyword can be used to define async functions inside expressions."> enunciado de función asíncrona</a>.</p>

<h2 id="Sintaxis">Sintaxis</h2>

<pre class="syntaxbox">async function [nombre]([<var>param1</var>[, <var>param2</var>[, ..., <var>paramN</var>]]]) {
   <var>enunciados</var>
}</pre>

<p>A partir de ES2015 (ES6), también se pueden emplear <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions/Arrow_functions">funciones flecha.</a></p>

<h3 id="Parámetros">Parámetros</h3>

<dl>
 <dt><code><var>name</var></code></dt>
 <dd>El nombre de la función. Puede ser omitida, en cuy caso la función es <em>anónima</em>. El nombre es sólo local al cuerpo de la función The name is only local to the function body.</dd>
 <dt><code><var>paramN</var></code></dt>
 <dd>El nombre de un argumento a ser pasado a la función.</dd>
 <dt><code><var>statements</var></code></dt>
 <dd>Los enunciados que componen el cuerpo de la función.</dd>
</dl>

<h2 id="Descripción">Descripción</h2>

<p>Una expresión <code>async function</code> es miuy similar, y casi tiene la misma sintaxis que, una {{jsxref('Statements/async_function', 'async function statement')}}. La principal diferencia entre una expresión <code>async function</code> y un enunciado <code>async function</code> es el <em>nombre de la función</em>, que puede ser omitido en una expresión <code>async function</code> para crear funciones <em>anonymous</em>. Una expresión <code>async function</code> puede ser utilizada como un {{Glossary("IIFE")}} (Expresión de función inmediatamente invocada, Immediately Invoked Function Expression) que se ejecuta tan rápido como es definida. Ver el capítulo sobre <a href="/en-US/docs/Web/JavaScript/Reference/Functions">funciones</a> para tener más información.</p>

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

<h3 id="Ejemplo_sencillo">Ejemplo sencillo</h3>

<pre class="brush: js">function resuelve2SegundosDespues(x) {
  return new Promise(resolve =&gt; {
    setTimeout(() =&gt; {
      resolve(x);
    }, 2000);
  });
};


const agregar= async function(x) { // Expresión de una función asíncrona asignada a una variable
  let a = await resuelve2SegundosDespues(20);
  let b = await resuelve2SegundosDespues(30);
  return x + a + b;
};

agregar(10).then(v =&gt; {
  console.log(v);  // imprime 60 después de 4 segundos.
});


(async function(x) { // expresión de una función asíncrona utilizada como una IIFE
  let p_a = resuelve2SegundosDespues(20);
  let p_b = resuelve2SegundosDespues(30);
  return x + await p_a + await p_b;
})(10).then(v =&gt; {
  console.log(v);  // imprime 60 después de 2 segundos.
});
</pre>

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

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Especificación</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('ESDraft', '#sec-async-function-definitions', 'async function')}}</td>
  </tr>
 </tbody>
</table>

<h2 id="Compatibilidad_de_los_navegadores">Compatibilidad de los navegadores</h2>

<div>


<p>{{Compat("javascript.operators.async_function_expression")}}</p>
</div>

<h2 id="Ver_también">Ver también</h2>

<ul>
 <li>{{jsxref("Statements/async_function", "async function")}}</li>
 <li>Objeto {{jsxref("AsyncFunction")}}</li>
 <li>{{jsxref("Operators/await", "await")}}</li>
</ul>