From bf8e099b9c8b3c60d60b3712b4fc97b052c39887 Mon Sep 17 00:00:00 2001 From: julieng Date: Tue, 3 Aug 2021 08:03:23 +0200 Subject: convert content to md --- .../global_objects/asyncfunction/index.md | 129 +++++++++------------ 1 file changed, 55 insertions(+), 74 deletions(-) (limited to 'files/fr/web/javascript/reference/global_objects/asyncfunction') diff --git a/files/fr/web/javascript/reference/global_objects/asyncfunction/index.md b/files/fr/web/javascript/reference/global_objects/asyncfunction/index.md index 778e94b924..53d4c091aa 100644 --- a/files/fr/web/javascript/reference/global_objects/asyncfunction/index.md +++ b/files/fr/web/javascript/reference/global_objects/asyncfunction/index.md @@ -9,66 +9,62 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/AsyncFunction original_slug: Web/JavaScript/Reference/Objets_globaux/AsyncFunction --- -
{{JSRef}}
+{{JSRef}} -

Le constructeur AsyncFunction crée un nouvel objet pour {{jsxref("Instructions/async function", "une fonction asynchrone","",1)}}. En JavaScript, chaque fonction asynchrone est en fait un objet AsyncFunction.

+Le constructeur **`Async`\*\***`Function`\*\* crée un nouvel objet pour {{jsxref("Instructions/async function", "une fonction asynchrone","",1)}}. 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 :

+Attention, `AsyncFunction` n'est pas un objet global. On peut l'obtenir grâce au code suivant : -
Object.getPrototypeOf(async function(){}).constructor
-
+```js +Object.getPrototypeOf(async function(){}).constructor +``` -

Syntaxe

+## Syntaxe -
new AsyncFunction ([arg1[, arg2[, ...argN]],] functionBody)
+ new AsyncFunction ([arg1[, arg2[, ...argN]],] functionBody) -

Paramètres

+### 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.
-
+- `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

+## Description -

Les objets des {{jsxref("Instructions/async_function", "fonctions asynchrones","",1)}} 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 {{jsxref("Instructions/async_function", "expression de fonction asynchrone")}} et de l'appeler depuis le code car ces fonctions sont analysées avec le reste du code.

+Les objets des {{jsxref("Instructions/async_function", "fonctions asynchrones","",1)}} 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 {{jsxref("Instructions/async_function", "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.

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

Note : Les fonctions asynchrones créées avec le constructeur AsyncFunction ne créent pas de fermetutres dans leurs contextes de création. Elles sont toujours créées dans la portée globale. Lorsqu'on les exécute, ellee ne pourront accéder qu'à leurs variables locales et aux variables globales, pas à celles qui appartiennent à la portée dans laquelle AsyncFunction a été appelé. On aurait donc un comportement différent  si on appelait {{jsxref("Objets_globaux/eval", "eval")}} avec le code de l'expression de la fonction asynchrone.

-
+> **Note :** Les fonctions asynchrones créées avec le constructeur `AsyncFunction` ne créent pas de fermetutres dans leurs contextes de création. Elles sont toujours créées dans la portée globale. Lorsqu'on les exécute, ellee ne pourront accéder qu'à leurs variables locales et aux variables globales, pas à celles qui appartiennent à la portée dans laquelle `AsyncFunction` a été appelé. On aurait donc un comportement différent  si on appelait {{jsxref("Objets_globaux/eval", "eval")}} avec le code de l'expression de la fonction asynchrone. -

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.

+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

+## Propriétés -
-
AsyncFunction.length
-
La propriété de longueur du constructeur AsyncFunction dont la valeur est 1.
-
{{jsxref("AsyncFunction.prototype")}}
-
Le prototype permet d'ajouter des propriétés à tous les objets représentant les fonctions asynchrones.
-
+- **`AsyncFunction.length`** + - : La propriété de longueur du constructeur `AsyncFunction` dont la valeur est 1. +- {{jsxref("AsyncFunction.prototype")}} + - : Le prototype permet d'ajouter des propriétés à tous les objets représentant les fonctions asynchrones. -

Prototype de l'objet AsyncFunction

+## Prototype de l'objet `AsyncFunction` -

Propriétés

+### Propriétés -
{{page('/fr/docs/Web/JavaScript/Reference/Objets_globaux/AsyncFunction/prototype', 'Propriétés')}}
+{{page('/fr/docs/Web/JavaScript/Reference/Objets_globaux/AsyncFunction/prototype', 'Propriétés')}} -

Instances AsyncFunction

+## Instances `AsyncFunction` -

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

+Les instances d'`AsyncFunction` héritent des méthodes et des propriétés de {{jsxref("AsyncFunction.prototype")}}. Comme avec les autres constructeurs, on peut changer l'objet prototype du constructeur afin de modifier l'ensemble des instances `AsyncFunction`. -

Exemples

+## Exemples -

Créer une fonction asynchrone avec un constructeur AsyncFunction

+### Créer une fonction asynchrone avec un constructeur `AsyncFunction` -
function resolveAfter2Seconds(x) {
-  return new Promise(resolve => {
-    setTimeout(() => {
+```js
+function resolveAfter2Seconds(x) {
+  return new Promise(resolve => {
+    setTimeout(() => {
       resolve(x);
     }, 2000);
   });
@@ -78,41 +74,26 @@ 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 => {
+a(10, 20).then(v => {
   console.log(v); // affiche 30 après 4 secondes
 });
-
- -

Spécifications

- - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('ESDraft', '#sec-async-function-objects', 'AsyncFunction object')}}{{Spec2('ESDraft')}}Définition initiale dans ES2017.
- -

Compatibilité des navigateurs

- -

{{Compat("javascript.builtins.AsyncFunction")}}

- -

Voir aussi

- - +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------------------- | ---------------------------- | -------------------------------- | +| {{SpecName('ESDraft', '#sec-async-function-objects', 'AsyncFunction object')}} | {{Spec2('ESDraft')}} | Définition initiale dans ES2017. | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.AsyncFunction")}} + +## Voir aussi + +- Instruction {{jsxref("Instructions/async_function", "async function")}} +- Expression {{jsxref("Opérateurs/async_function","async function")}} +- {{jsxref("Objets_globaux/Function", "Function")}} +- Instruction {{jsxref("Instructions/function", "function")}} +- Expression {{jsxref("Opérateurs/function", "function")}} +- {{jsxref("Fonctions", "Fonctions et portées des fonctions", "", 1)}} -- cgit v1.2.3-54-g00ecf