diff options
| -rw-r--r-- | files/es/web/javascript/reference/global_objects/asyncfunction/index.html | 123 | ||||
| -rw-r--r-- | files/es/web/javascript/reference/global_objects/asyncfunction/index.md | 94 |
2 files changed, 94 insertions, 123 deletions
diff --git a/files/es/web/javascript/reference/global_objects/asyncfunction/index.html b/files/es/web/javascript/reference/global_objects/asyncfunction/index.html deleted file mode 100644 index c818140ae7..0000000000 --- a/files/es/web/javascript/reference/global_objects/asyncfunction/index.html +++ /dev/null @@ -1,123 +0,0 @@ ---- -title: Funciones asíncronas -slug: Web/JavaScript/Reference/Global_Objects/AsyncFunction -translation_of: Web/JavaScript/Reference/Global_Objects/AsyncFunction -original_slug: Web/JavaScript/Referencia/Objetos_globales/Funcionesasíncronas ---- -<div>{{JSRef}}</div> - -<div>El constructor de las funciones asíncronas crea un nuevo objecto {{jsxref("Statements/async_function", "async function")}}. En JavaScript cada función asíncrona es un objeto AsyncFunction.</div> - -<div></div> - -<div>Nota: AsyncFunction no es un objeto global. Este puede ser obtenido como resultado del siguiente código.</div> - -<div></div> - -<pre class="brush: js notranslate">Object.getPrototypeOf(async function(){}).constructor -</pre> - -<h2 id="Syntax">Syntax</h2> - -<pre class="syntaxbox notranslate">new AsyncFunction([<var>arg1</var>[, <var>arg2</var>[, ...<var>argN</var>]],] <var>functionBody</var>)</pre> - -<h3 id="Parametros">Parametros</h3> - -<dl> - <dt><code>arg1, arg2, ... arg<em>N</em></code></dt> - <dd>Nombres a ser usados por la función como los nombres de los argumentos. Cada uno debe ser una cadena que corresponda a un identificador válido en JavaScript o una lista de cadenas separadas por coma, ejemplo: "<code>x</code>", "<code>theValue</code>", or "<code>a,b</code>".</dd> - <dt><code>functionBody</code></dt> - <dd>Una cadena que contiene las declaraciones de JavaScript que comprenden la definición de la función.</dd> -</dl> - -<h2 id="Descripción">Descripción</h2> - -<p>{{jsxref("Statements/async_function", "async function")}} los objetos creados con el constructor <code>AsyncFunction</code> son analizados gramaticalmente en el momento que la función es creada. Esto es menos eficiente que declarar una función asincrona con un {{jsxref("Statements/async_function", "async function expression")}} y llamarla con eso en tu código , ya que las funciones están analizadas gramaticalmento junto al resto del código.</p> - -<p>Todos los argumentos que son pasados por la función son tratados por los nombres de los identificadores con los que fueron creados, en el orden en que son pasados por la función.</p> - -<div class="note"> -<p><strong>Note:</strong> {{jsxref("Statements/async_function", "async functions")}} created with the <code>AsyncFunction</code> constructor do not create closures to their creation contexts; they are always created in the global scope. When running them, they will only be able to access their own local variables and global ones, not the ones from the scope in which the <code>AsyncFunction</code> constructor was called. This is different from using {{jsxref("Global_Objects/eval", "eval")}} with code for an async function expression.</p> -</div> - -<p>Invoking the <code>AsyncFunction</code> constructor as a function (without using the <code>new</code> operator) has the same effect as invoking it as a constructor.</p> - -<h2 id="Propiedades">Propiedades</h2> - -<dl> - <dt><code><strong>AsyncFunction.length</strong></code></dt> - <dd>The <code>AsyncFunction</code> constructor's length property whose value is 1.</dd> - <dt>{{jsxref("AsyncFunction.prototype")}}</dt> - <dd>Allows the addition of properties to all async function objects.</dd> -</dl> - -<h2 id="El_objeto_prototipo_AsyncFunction">El objeto prototipo <code> AsyncFunction</code> </h2> - -<h3 id="Propiedades_2">Propiedades</h3> - -<div>{{page('/en-US/docs/Web/JavaScript/Reference/Global_Objects/AsyncFunction/prototype', 'Properties')}}</div> - -<h2 id="AsyncFunction_y_sus_instancias"><code>AsyncFunction</code> y sus instancias</h2> - -<p>Una instancia de <code>AsyncFunction</code> hereda métodos y propiedades de {{jsxref("AsyncFunction.prototype")}}. Como son todos los constructores, puedes cambiar el constructor del objeto prototipo para aplicar cambios a todas las instancias de <code>AsyncFunction</code> .</p> - -<h2 id="Ejemplos">Ejemplos</h2> - -<h3 id="Creating_an_async_function_from_an_AsyncFunction_constructor">Creating an async function from an <code>AsyncFunction</code> constructor</h3> - -<pre class="brush: js notranslate">function resolveAfter2Seconds(x) { - return new Promise(resolve => { - setTimeout(() => { - resolve(x); - }, 2000); - }); -} - -var AsyncFunction = Object.getPrototypeOf(async function(){}).constructor - -var a = new AsyncFunction('a', - 'b', - 'return await resolveAfter2Seconds(a) + await resolveAfter2Seconds(b);'); - -a(10, 20).then(v => { - console.log(v); // prints 30 after 4 seconds -}); -</pre> - -<h2 id="Especificaciones">Especificaciones</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('ESDraft', '#sec-async-function-objects', 'AsyncFunction object')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td>Initial definition in ES2017.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidad_del_navegador">Compatibilidad del navegador</h2> - -<div> - - -<p>{{Compat("javascript.builtins.AsyncFunction")}}</p> -</div> - -<h2 id="Ver_también">Ver también</h2> - -<ul> - <li>{{jsxref("Statements/async_function", "async function function")}}</li> - <li>{{jsxref("Operators/async_function", "async function expression")}}</li> - <li>{{jsxref("Global_Objects/Function", "Function")}}</li> - <li>{{jsxref("Statements/function", "function statement")}}</li> - <li>{{jsxref("Operators/function", "function expression")}}</li> - <li>{{jsxref("Functions_and_function_scope", "Functions and function scope", "", 1)}}</li> -</ul> diff --git a/files/es/web/javascript/reference/global_objects/asyncfunction/index.md b/files/es/web/javascript/reference/global_objects/asyncfunction/index.md new file mode 100644 index 0000000000..36161f7851 --- /dev/null +++ b/files/es/web/javascript/reference/global_objects/asyncfunction/index.md @@ -0,0 +1,94 @@ +--- +title: Funciones asíncronas +slug: Web/JavaScript/Reference/Global_Objects/AsyncFunction +translation_of: Web/JavaScript/Reference/Global_Objects/AsyncFunction +original_slug: Web/JavaScript/Referencia/Objetos_globales/Funcionesasíncronas +browser-compat: javascript.builtins.AsyncFunction +--- +{{JSRef}} + +El **constructor `AsyncFunction`** crea un nuevo objeto {{jsxref("Statements/async_function", "async function", "", 1)}}. +En JavaScript, cada función asíncrona es un objeto `AsyncFunction`. + +Nota: `AsyncFunction` _no_ es un objeto global. Este puede ser obtenido como resultado del siguiente código. + +```js +Object.getPrototypeOf(async function(){}).constructor +``` + +## Sintaxis + +```js +new AsyncFunction(arg0, functionBody) +new AsyncFunction(arg0, arg1, functionBody) +new AsyncFunction(arg0, arg1, ...argN, functionBody) +``` + +### Parámetros + +- `arg1, arg2, ... argN` + + - : Nombres a ser usados por la función como los nombres de los argumentos. Cada uno debe ser una cadena que corresponda a un identificador válido en JavaScript (cualquier [identificador](/es/docs/Glossary/Identifier), [parámetro rest](/es/docs/Web/JavaScript/Reference/Functions/rest_parameters), o [parámetro desestructurado](/es/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment), opcionalmente con un valor por defecto), o una lista de tales cadenas separadas por comas. + + Así mismo, los parámetros se procesan de la misma manera que las declaraciones de funciones, aceptando espacios y comentarios. Por ejemplo: `"x", "theValue = 42", "[a, b] /* numbers */"` — o `"x, theValue = 42, [a, b] /* numbers */"`. (`"x, theValue = 42", "[a, b]"` es también correcto, pero muy confuso para leer). + +- : `functionBody` + - : Una cadena que contiene las sentencias de JavaScript que componen la definición de la función. + +## Descripción + +Los objetos {{jsxref("Statements/async_function", "async function")}} creados con el constructor `AsyncFunction` son procesados en el momento que la función es creada. Esto es menos eficiente que declarar una función asincrona con un {{jsxref("Statements/async_function", "async function expression")}} y llamarla con eso en tu código , ya que las funciones son procesadas junto al resto del código. + +Todos los argumentos que son pasados a la función son tratados por los nombres de los identificadores de los parámetros en la función creada, en el orden en que son pasados a la función. + +> **Nota:** Las {{jsxref("Statements/async_function", "async functions", "", 1)}} creadas con el constructor `AsyncFunction` no crean +> [_closures_](/es/docs/Web/JavaScript/Closures) en sus contextos creados, siempre son creados en el contexto global. +> +> Cuando se ejecutan, solamente podran acceder a sus variables locales y globales, no a las variables de otros contextos en el cual +> el constructor `AsyncFuction` fue llamado. +> +> Esto es distinto de usar {{jsxref("Global_Objects/eval", "eval")}} con código para +> una expresión de función asíncrona. + +Invocar el constructor `AsyncFunction` coomo una función (sin usar el operador `new`) tiene el mismo efecto que invocarlo como un constructor. + +## Ejemplos + +### Creando una función asíncrona con el constructor AsyncFunction() + +```js +function resolveAfter2Seconds(x) { + return new Promise(resolve => { + setTimeout(() => { + resolve(x); + }, 2000); + }); +} + +let AsyncFunction = Object.getPrototypeOf(async function(){}).constructor + +let a = new AsyncFunction('a', + 'b', + 'return await resolveAfter2Seconds(a) + await resolveAfter2Seconds(b);'); + +a(10, 20).then(v => { + console.log(v); // imprime 30 después de 4 segundos +}); +``` + +## Especificaciones + +{{Specifications}} + +## Compatibilidad con navegadores + +{{Compat}} + +## Véase también + +- {{jsxref("Statements/async_function", "async function function", "", 1)}} +- {{jsxref("Operators/async_function", "async function expression", "", 1)}} +- {{jsxref("Global_Objects/Function", "Function")}} +- {{jsxref("Statements/function", "function statement", "", 1)}} +- {{jsxref("Operators/function", "function expression", "", 1)}} +- {{jsxref("Functions", "Functions and function scope", "", 1)}} |