AsyncFunction

Le constructeur AsyncFunction crée un nouvel objet pour une fonction asynchrone. En JavaScript, chaque fonction asynchrone est en fait un objet AsyncFunction.

Attention, AsyncFunction n'est pas un objet global. On peut l'obtenir grâce au code suivant :

Object.getPrototypeOf(async function(){}).constructor

Syntaxe

new AsyncFunction ([arg1[, arg2[, ...argN]],] functionBody)

Paramètres

arg1, arg2, ... argN

Les noms des paramètres passés à la fonction. Chacun doit être une chaîne de caractères qui puisse être un identifiant JavaScript valide ou une liste de telles chaînes séparées par une virgule (ex. "x", "laValeur", ou "a,b").

functionBody

Une chaîne de caractères qui contient les instructions JavaScript définissant la définition de la fonction.

Description

Les objets des fonctions asynchrones créés avec le constructeur AsyncFunction sont analysés lorsque la fonction est créée. C'est moins efficace que de déclarer une fonction asynchrone avec une expression de fonction asynchrone et de l'appeler depuis le code car ces fonctions sont analysées avec le reste du code.

Tous les arguments passés à la fonction sont traités comme les noms des identifiants des paramètres de la fonction qui sera créée, dans l'ordre dans lequel ils sont passés.

Si on appelle AsyncFunction comme une fonction (c'est-à-dire sans new), cela aura le même effet que s'il est appelé comme un constructeur.

Propriétés

AsyncFunction.length

La propriété de longueur du constructeur AsyncFunction dont la valeur est 1.

AsyncFunction.prototype

Le prototype permet d'ajouter des propriétés à tous les objets représentant les fonctions asynchrones.

Prototype de l'objet AsyncFunction

Propriétés

Instances AsyncFunction

Les instances d'AsyncFunction héritent des méthodes et des propriétés de AsyncFunction.prototype. Comme avec les autres constructeurs, on peut changer l'objet prototype du constructeur afin de modifier l'ensemble des instances AsyncFunction.

Exemples

Créer une fonction asynchrone avec un constructeur AsyncFunction

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

var AsyncFunction = Object.getPrototypeOf(async function(){}).constructor
var a = new AsyncFunction("a",
                          "b",
                          "return await resolveAfter2Seconds(a) + await resolveAfter2Seconds(b);");
a(10, 20).then(v => {
  console.log(v); // affiche 30 après 4 secondes
});

Spécifications

Compatibilité des navigateurs

Voir aussi

• Instruction async function
• Expression async function
• Function
• Instruction function
• Expression function
• Fonctions et portées des fonctions