Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Opérateur await — attendre un résultat

Une expression await suspend l’exécution en cours d’une fonction asynchrone ou d’un module jusqu’à ce que la valeur attendue soit réglée. Elle produit la valeur de réalisation d’une promesse ou lance sa raison de rejet, sans bloquer l’ensemble du thread.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

await expression

await expression évalue son opérande et attend son résultat à l’aide du mécanisme des promesses. Si la promesse est réalisée, l’expression await fournit sa valeur de réalisation ; si elle est rejetée, sa raison est lancée comme exception à cet endroit. Vous pouvez la traiter avec try...catch. Les valeurs ordinaires et les thenables — des objets dotés d’une méthode then appelable — sont également acceptés.

await suspend l’exécution en cours d’une fonction asynchrone ou d’un module, et non l’ensemble du thread. Même une valeur ordinaire ou une promesse déjà réalisée entraîne une reprise asynchrone. C’est pourquoi outside apparaît avant 42 dans l’exemple. await ne déplace pas à lui seul le calcul vers un autre thread.

Utilisez-le dans le corps d’une fonction async (y compris un générateur asynchrone) ou au niveau supérieur d’un module. Un script ordinaire ou une fonction ordinaire imbriquée dans une fonction async ne bénéficie pas de cette autorisation. await exige un opérande et ne peut pas apparaître dans les initialiseurs de paramètres d’une fonction asynchrone. Son emploi comme identifiant est soumis à des restrictions selon le contexte ; évitez ce nom.

Des instructions await consécutives peuvent sérialiser inutilement des opérations indépendantes. Pour attendre ensemble plusieurs opérations indépendantes, démarrez-les d’abord, puis utilisez await Promise.all(...). La prise en charge de la syntaxe await ne garantit pas la disponibilité d’une quelconque API Web dans l’environnement.

Exemples

async function main() {
  console.log("start");
  const value = await Promise.resolve(42);
  console.log(value);
}

main().catch(console.error);
console.log("outside");

Résultat

start
outside
42

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources