CKTIS / JavaScript
Operador await — esperar un resultado
Una expresión await suspende la ejecución actual de una función asíncrona o de un módulo hasta que se resuelva el valor esperado. Produce el valor de cumplimiento de una promesa o lanza el motivo de su rechazo, sin bloquear todo el hilo.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
await expressionawait expression evalúa su operando y espera su resultado mediante el mecanismo de las promesas. Si la promesa se cumple, la expresión await proporciona el valor de cumplimiento; si se rechaza, lanza el motivo del rechazo como excepción en ese punto. Puedes gestionarlo con try...catch. También se aceptan valores ordinarios y thenables, es decir, objetos con un método then invocable.
await suspende la ejecución actual de una función asíncrona o de un módulo, no todo el hilo. Incluso un valor ordinario o una promesa ya cumplida hace que la ejecución se reanude de forma asíncrona. Por eso outside aparece antes de 42 en el ejemplo. await por sí mismo no traslada el cálculo a otro hilo.
Úsalo dentro del cuerpo de una función async (también de un generador asíncrono) o en el nivel superior de un módulo. Un script ordinario o una función ordinaria anidada dentro de una función async no obtiene ese permiso. await requiere un operando y no puede aparecer en los inicializadores de parámetros de una función asíncrona. Su uso como identificador está restringido según el contexto; evita ese nombre.
Varias instrucciones await consecutivas pueden serializar innecesariamente operaciones independientes. Para esperar a varias operaciones independientes a la vez, inícialas primero y después usa await Promise.all(...). La compatibilidad con la sintaxis await no demuestra que el entorno disponga de ninguna API web.
Ejemplos
async function main() {
console.log("start");
const value = await Promise.resolve(42);
console.log(value);
}
main().catch(console.error);
console.log("outside");Resultado
start outside 42
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.