KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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 expression

await 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.

Bronnen