From dfb72609be85ff3eff42a4c93643af5042fa1acb Mon Sep 17 00:00:00 2001 From: Anderson Vallejo <48649209+Vallejoanderson@users.noreply.github.com> Date: Mon, 21 Feb 2022 12:22:27 -0500 Subject: Content sync and updated to md | global_objects/asyncfunction [ES] (#4169) * sync and updated to md * Apply suggestions from code review Co-authored-by: Alexander --- .../global_objects/asyncfunction/index.html | 123 --------------------- .../global_objects/asyncfunction/index.md | 94 ++++++++++++++++ 2 files changed, 94 insertions(+), 123 deletions(-) delete mode 100644 files/es/web/javascript/reference/global_objects/asyncfunction/index.html create mode 100644 files/es/web/javascript/reference/global_objects/asyncfunction/index.md 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 ---- -
{{JSRef}}
- -
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.
- -
- -
Nota: AsyncFunction no es un objeto global. Este puede ser obtenido como resultado del siguiente código.
- -
- -
Object.getPrototypeOf(async function(){}).constructor
-
- -

Syntax

- -
new AsyncFunction([arg1[, arg2[, ...argN]],] functionBody)
- -

Parametros

- -
-
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 o una lista de cadenas separadas por coma, ejemplo: "x", "theValue", or "a,b".
-
functionBody
-
Una cadena que contiene las declaraciones de JavaScript que comprenden la definición de la función.
-
- -

Descripción

- -

{{jsxref("Statements/async_function", "async function")}} los objetos creados con el constructor AsyncFunction 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.

- -

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.

- -
-

Note: {{jsxref("Statements/async_function", "async functions")}} created with the AsyncFunction 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 AsyncFunction constructor was called. This is different from using {{jsxref("Global_Objects/eval", "eval")}} with code for an async function expression.

-
- -

Invoking the AsyncFunction constructor as a function (without using the new operator) has the same effect as invoking it as a constructor.

- -

Propiedades

- -
-
AsyncFunction.length
-
The AsyncFunction constructor's length property whose value is 1.
-
{{jsxref("AsyncFunction.prototype")}}
-
Allows the addition of properties to all async function objects.
-
- -

El objeto prototipo  AsyncFunction 

- -

Propiedades

- -
{{page('/en-US/docs/Web/JavaScript/Reference/Global_Objects/AsyncFunction/prototype', 'Properties')}}
- -

AsyncFunction y sus instancias

- -

Una instancia de AsyncFunction  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 AsyncFunction .

- -

Ejemplos

- -

Creating an async function from an AsyncFunction constructor

- -
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
-});
-
- -

Especificaciones

- - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ESDraft', '#sec-async-function-objects', 'AsyncFunction object')}}{{Spec2('ESDraft')}}Initial definition in ES2017.
- -

Compatibilidad del navegador

- -
- - -

{{Compat("javascript.builtins.AsyncFunction")}}

-
- -

Ver también

- - 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)}} -- cgit v1.2.3-54-g00ecf