Expression async function

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2017.

Le mot-clé async function peut être utilisé pour définir une fonction asynchrone au sein d'une expression.

Note : Il est aussi possible de définir une fonction asynchrone en utilisant une instruction async function.

Syntaxe

js
async function [name]([param1[, param2[,, paramN]]]) {
  instructions
}

Paramètres

name

Le nom de la fonction. Il est facultatif et s'il n'est pas utilisé, la fonction est anonyme. Le nom utilisé est uniquement local pour le corps de la fonction.

paramN

Le nom d'un argument à passer à la fonction.

instructions

Les instructions qui composent le corps de la fonction.

Note : À partir d'ES2015 (ES6), il est aussi possible d'utiliser des fonctions fléchées pour les expressions de fonction asynchrone.

Description

Une expression async function est très proche, et partage quasiment la même syntaxe avec une instruction async function. La différence principale entre une expression async function et une instruction async function est qu'on peut omettre le nom de la fonction dans les expressions async function. On peut donc utiliser une expression async function afin de créer une IIFE (pour Immediately Invoked Function Expression) qu'on appelle au moment de sa définition. Voir également le chapitre sur les fonctions pour plus d'informations.

Exemples

Exemple simple

js
function resolveAfter2Seconds(x) {
  return new Promise((resolve) => {
    setTimeout(() => {
      resolve(x);
    }, 2000);
  });
}

(async function (x) {
  // fonction asynchrone immédiatement appelée
  var a = resolveAfter2Seconds(20);
  var b = resolveAfter2Seconds(30);
  return x + (await a) + (await b);
})(10).then((v) => {
  console.log(v); // affiche 60 après 2 secondes.
});

var add = async function (x) {
  var a = await resolveAfter2Seconds(20);
  var b = await resolveAfter2Seconds(30);
  return x + a + b;
};

add(10).then((v) => {
  console.log(v); // affiche 60 après 4 secondes.
});

Spécifications

Specification
ECMAScript Language Specification
# sec-async-function-definitions

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi