CKTIS / JavaScript
await-operator — wachten op een resultaat
Een await-expressie onderbreekt de huidige uitvoering van een asynchrone functie of module totdat de verwachte waarde is afgehandeld. De expressie levert de vervullingswaarde van een promise op of werpt de reden voor de afwijzing, zonder de volledige thread te blokkeren.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
await expressionawait expression evalueert de operand en wacht via het promise-mechanisme op het resultaat. Bij vervulling levert de await-expressie de vervullingswaarde; bij afwijzing werpt deze de reden daarvoor op die plek als uitzondering. Je kunt die afhandeling doen met try...catch. Gewone waarden en thenables — objecten met een aanroepbare then-methode — worden ook geaccepteerd.
await onderbreekt de huidige uitvoering van een asynchrone functie of module, niet de volledige thread. Zelfs een gewone waarde of een al vervulde promise zorgt ervoor dat de uitvoering asynchroon wordt hervat. Daarom verschijnt outside vóór 42 in het voorbeeld. await verplaatst de berekening zelf niet naar een andere thread.
Gebruik het in de body van een async-functie (ook een asynchrone generator) of op het hoogste niveau van een module. Een gewoon script of een gewone functie binnen een async-functie krijgt die toestemming niet. await vereist een operand en mag niet voorkomen in parameterinitialisaties van een asynchrone functie. Het gebruik als identifier is afhankelijk van de context beperkt; vermijd die naam.
Opeenvolgende await-instructies kunnen onafhankelijke bewerkingen onnodig na elkaar uitvoeren. Als je op meerdere onafhankelijke bewerkingen tegelijk wilt wachten, start je ze eerst en gebruik je daarna await Promise.all(...). Ondersteuning voor de await-syntaxis betekent niet dat een bepaalde Web-API in de omgeving beschikbaar is.
Voorbeelden
async function main() {
console.log("start");
const value = await Promise.resolve(42);
console.log(value);
}
main().catch(console.error);
console.log("outside");Resultaat
start outside 42
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.