Funciones asíncronas
BaselineWidely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2017.
ElconstructorAsyncFunction
crea un nuevo objetoasync function.En JavaScript, cada función asíncrona es un objetoAsyncFunction
.
Nota:AsyncFunction
no es un objeto global. Este puede ser obtenido como resultado del siguiente código.
Object.getPrototypeOf(async function () {}).constructor;
Sintaxis
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 (cualquieridentificador,parámetro rest, oparámetro desestructurado, 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 objetosasync function
creados con el constructorAsyncFunction
son procesados en el momento que la función es creada. Esto es menos eficiente que declarar una función asincrona con unasync 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:Lasasync functions creadas con el constructorAsyncFunction
no creanclosures 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 cualel constructorAsyncFuction
fue llamado.
Esto es distinto de usareval
con código parauna expresión de función asíncrona.
Invocar el constructorAsyncFunction
coomo una función (sin usar el operadornew
) tiene el mismo efecto que invocarlo como un constructor.
Ejemplos
Creando una función asíncrona con el constructor AsyncFunction()
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
Specification |
---|
ECMAScript® 2026 Language Specification # sec-async-function-objects |