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 --- .../reference/functions/arrow_functions/index.md | 349 +++++++++++---------- 1 file changed, 176 insertions(+), 173 deletions(-) (limited to 'files/fr/web/javascript/reference/functions/arrow_functions') diff --git a/files/fr/web/javascript/reference/functions/arrow_functions/index.md b/files/fr/web/javascript/reference/functions/arrow_functions/index.md index 8beaaa3098..c40336f008 100644 --- a/files/fr/web/javascript/reference/functions/arrow_functions/index.md +++ b/files/fr/web/javascript/reference/functions/arrow_functions/index.md @@ -9,66 +9,62 @@ tags: translation_of: Web/JavaScript/Reference/Functions/Arrow_functions original_slug: Web/JavaScript/Reference/Fonctions/Fonctions_fléchées --- -
{{jsSidebar("Functions")}}
+{{jsSidebar("Functions")}} -

Une expression de fonction fléchée (arrow function en anglais) permet d’avoir une syntaxe plus courte que les expressions de fonction et ne possède pas ses propres valeurs pour this, arguments, super, ou new.target. Les fonctions fléchées sont souvent anonymes et ne sont pas destinées à être utilisées pour déclarer des méthodes.

+Une **expression de fonction fléchée** (_arrow function_ en anglais) permet d’avoir une syntaxe plus courte que [les expressions de fonction](/fr/docs/Web/JavaScript/Reference/Opérateurs/L_opérateur_function) et ne possède pas ses propres valeurs pour [`this`](/fr/docs/Web/JavaScript/Reference/Opérateurs/L_opérateur_this), [`arguments`](/fr/docs/Web/JavaScript/Reference/Fonctions/arguments), [`super`](/fr/docs/Web/JavaScript/Reference/Op%C3%A9rateurs/super), ou [`new.target`](/fr/docs/Web/JavaScript/Reference/Op%C3%A9rateurs/new.target). Les fonctions fléchées sont souvent [anonymes](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Function/name) et ne sont pas destinées à être utilisées pour déclarer des méthodes. -
{{EmbedInteractiveExample("pages/js/functions-arrow.html")}}
+{{EmbedInteractiveExample("pages/js/functions-arrow.html")}} -

Syntaxe

+## Syntaxe -
([param] [, param]) => {
-   instructions
-}
+    ([param] [, param]) => {
+       instructions
+    }
 
-(param1, param2, …, param2) => expression
-// équivalent à
-(param1, param2, …, param2) => {
-  return expression;
-}
+    (param1, param2, …, param2) => expression
+    // équivalent à
+    (param1, param2, …, param2) => {
+      return expression;
+    }
 
-// Parenthèses non nécessaires quand il n'y a qu'un seul argument
-param => expression
+    // Parenthèses non nécessaires quand il n'y a qu'un seul argument
+    param => expression
 
-// Une fonction sans paramètre peut s'écrire avec un couple
-// de parenthèses
-() => {
-  instructions
-}
+    // Une fonction sans paramètre peut s'écrire avec un couple
+    // de parenthèses
+    () => {
+      instructions
+    }
 
-// Gestion des paramètres du reste et paramètres par défaut
-(param1, param2, ...reste) => {
-  instructions
-}
-(param1 = valeurDefaut1, param2, …, paramN = valeurDefautN) => {
-  instructions
-}
+    // Gestion des paramètres du reste et paramètres par défaut
+    (param1, param2, ...reste) => {
+      instructions
+    }
+    (param1 = valeurDefaut1, param2, …, paramN = valeurDefautN) => {
+      instructions
+    }
 
-// Gestion de la décomposition pour la liste des paramètres
-let f = ([a, b] = [1, 2], {x: c} = {x: a + b}) => a + b + c;
-f();
-
+ // Gestion de la décomposition pour la liste des paramètres + let f = ([a, b] = [1, 2], {x: c} = {x: a + b}) => a + b + c; + f(); -
-
param
-
Le nom d’un argument. S’il n'y a aucun argument, cela doit être indiqué par une paire de parenthèses (). S’il n'y a qu’un argument, les parenthèses ne sont pas nécessaires (ex. : toto => 1).
-
instructions ou expression
-
Plusieurs instructions doivent être encadrées par des accolades, {}. Une expression simple ne nécessite pas d’accolades. L’expression est également la valeur de retour implicite pour cette fonction.
-
+- `param` + - : Le nom d’un argument. S’il n'y a aucun argument, cela doit être indiqué par une paire de parenthèses `()`. S’il n'y a qu’un argument, les parenthèses ne sont pas nécessaires (ex. : `toto => 1`). +- `instructions` ou `expression` + - : Plusieurs instructions doivent être encadrées par des accolades, {}. Une expression simple ne nécessite pas d’accolades. L’expression est également la valeur de retour implicite pour cette fonction. -

Description

+## Description -

Deux facteurs sont à l’origine de la conception des fonctions fléchées : une syntaxe plus courte et l’absence de this spécifique à la fonction. Sur ce dernier point, cela signifie qu’une fonction fléchée ne lie pas son propre {{jsxref("Opérateurs/L_opérateur_this","this")}} au sein de la fonction (il en va de même avec {{jsxref("Fonctions/arguments","arguments")}}, {{jsxref("Opérateurs/super","super")}} ou {{jsxref("Opérateurs/new.target","new.target")}}).

+Deux facteurs sont à l’origine de la conception des fonctions fléchées : une syntaxe plus courte et l’absence de `this` spécifique à la fonction. Sur ce dernier point, cela signifie qu’une fonction fléchée ne lie pas son propre {{jsxref("Opérateurs/L_opérateur_this","this")}} au sein de la fonction (il en va de même avec {{jsxref("Fonctions/arguments","arguments")}}, {{jsxref("Opérateurs/super","super")}} ou {{jsxref("Opérateurs/new.target","new.target")}}). -
-

Note : Voir aussi l’article sur les fonctions fléchées présent sur https://tech.mozfr.org/post/2015/06/10/ES6-en-details-%3A-les-fonctions-flechees (l’article original en anglais est disponible ici).

-
+> **Note :** Voir aussi l’article sur les fonctions fléchées présent sur (l’article original en anglais est disponible [ici](https://hacks.mozilla.org/2015/06/es6-in-depth-arrow-functions/)). -

Syntaxe plus courte

+### Syntaxe plus courte -

Pour des aspects fonctionnels, la légèreté de la syntaxe est bienvenue. Par exemple :

+Pour des aspects fonctionnels, la légèreté de la syntaxe est bienvenue. Par exemple : -
var a = [
+```js
+var a = [
   "We're up all night 'til the sun",
   "We're up all night to get some",
   "We're up all night for good fun",
@@ -80,22 +76,22 @@ var a2 = a.map(function (s) { return s.length });
 // [31, 30, 31, 31]
 
 // Avec, on a quelque chose de plus concis
-var a3 = a.map( s => s.length);
-// [31, 30, 31, 31]
+var a3 = a.map( s => s.length); +// [31, 30, 31, 31] +``` -

Pas de this lié à la fonction

+### Pas de `this` lié à la fonction -

Jusqu’a l’apparition des fonctions fléchées, chaque nouvelle fonction définissait son propre {{jsxref("Opérateurs/L_opérateur_this","this")}} :

+Jusqu’a l’apparition des fonctions fléchées, chaque nouvelle fonction définissait son propre {{jsxref("Opérateurs/L_opérateur_this","this")}} : - +- un nouvel objet dans le cas d’un constructeur +- `undefined` dans les appels de fonctions en [mode strict](/fr/docs/Web/JavaScript/Reference/Strict_mode) +- l’objet courant si la fonction est appelée comme une méthode, etc. -

Cela a pu entraîner des confusions lorsqu’on utilisait un style de programmation orientée objet.

+Cela a pu entraîner des confusions lorsqu’on utilisait un style de programmation orientée objet. -
function Personne () {
+```js
+function Personne () {
   // Le constructeur Personne() définit `this` comme lui-même.
   this.age = 0;
 
@@ -107,11 +103,13 @@ var a3 = a.map( s => s.length);
   }, 1000);
 }
 
-var p = new Personne();
+var p = new Personne(); +``` -

Avec ECMAScript 3/5, ce problème a pu être résolu en affectant la valeur de this à une autre variable :

+Avec ECMAScript 3/5, ce problème a pu être résolu en affectant la valeur de `this` à une autre variable : -
function Personne () {
+```js
+function Personne () {
   var that = this;
   that.age = 0;
 
@@ -120,46 +118,52 @@ var p = new Personne();
// qui est le contexte souhaité that.age++; }, 1000); -} +} +``` -

Autrement, on aurait pu utiliser une fonction de liaison afin que la bonne valeur this soit passée à la fonction grandir.

+Autrement, on aurait pu utiliser une [fonction de liaison](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Function/bind) afin que la bonne valeur `this` soit passée à la fonction `grandir`. -

Les fonctions fléchées ne créent pas de nouveau contexte, elles utilisent la valeur this de leur contexte. Aussi, si le mot-clé this est utilisé dans le corps de la fonction, le moteur recherchera la référence à cette valeur dans une portée parente. Le code qui suit fonctionne ainsi de la façon attendue car le this utilisé dans setInterval est le thisde la portée de Personne :

+Les fonctions fléchées ne créent pas de nouveau contexte, elles utilisent la valeur `this` de leur contexte. Aussi, si le mot-clé `this` est utilisé dans le corps de la fonction, le moteur recherchera la référence à cette valeur dans une portée parente. Le code qui suit fonctionne ainsi de la façon attendue car le `this` utilisé dans `setInterval` est le `this`de la portée de `Personne` : -
function Personne () {
+```js
+function Personne () {
   this.age = 0;
 
-  setInterval(() => {
+  setInterval(() => {
     this.age++;
     // |this| fait bien référence à l'objet personne
   }, 1000);
 }
 
-var p = new Personne();
+var p = new Personne(); +``` -

Liens avec le mode strict

+#### Liens avec le mode strict -

Ici this provient du contexte englobant, les règles du mode strict sont donc ignorées pour ce qui concerne this.

+Ici `this` provient du contexte englobant, les règles du [mode strict](/fr/docs/Web/JavaScript/Reference/Fonctions_et_portee_des_fonctions/Strict_mode) sont donc ignorées pour ce qui concerne `this`. -
var f = () => {'use strict'; return this};
-f() === window; // ou l'objet global
+```js +var f = () => {'use strict'; return this}; +f() === window; // ou l'objet global +``` -

Le reste des règles du mode strict sont appliquées normalement.

+Le reste des règles du mode strict sont appliquées normalement. -

Appel via {{jsxref("Function.prototype.call()")}} ou {{jsxref("Function.prototype.apply()")}}

+#### Appel via {{jsxref("Function.prototype.call()")}} ou {{jsxref("Function.prototype.apply()")}} -

Étant donné que this provient du contexte englobant, si on invoque une fonction via la méthode call ou apply, cela ne passera que des arguments mais n’aura aucun effet sur this :

+Étant donné que `this` provient du contexte englobant, si on invoque une fonction via la méthode `call` ou `apply`, cela ne passera que des arguments mais n’aura aucun effet sur `this` : -
var ajouter = {
+```js
+var ajouter = {
   base: 1,
 
   add : function (a) {
-    var f = v => v + this.base;
+    var f = v => v + this.base;
     return f(a);
   },
 
   addViaCall: function (a) {
-    var f = v => v + this.base;
+    var f = v => v + this.base;
     var b = {
       base: 2
     };
@@ -172,42 +176,47 @@ console.log(ajouter.add(1));
 
 console.log(ajouter.addViaCall(1));
 // Cela affichera toujours 2
-
+``` -

Pas de liaison pour arguments

+#### Pas de liaison pour `arguments` -

Les fonctions fléchées n’exposent pas d’objet arguments : arguments.length, arguments[0], arguments[1], et autres ne font donc pas référence aux arguments passés à la fonction fléchés. Dans ce cas arguments est simplement une référence à la variable de même nom si elle est présente dans la portée englobante :

+Les fonctions fléchées n’exposent pas d’objet [`arguments`](/fr/docs/Web/JavaScript/Reference/Fonctions/arguments) : `arguments.length`, `arguments[0]`, `arguments[1]`, et autres ne font donc pas référence aux arguments passés à la fonction fléchés. Dans ce cas `arguments` est simplement une référence à la variable de même nom si elle est présente dans la portée englobante : -
var arguments = [1, 2, 3];
-var arr = () => arguments[0];
+```js
+var arguments = [1, 2, 3];
+var arr = () => arguments[0];
 
 arr(); // 1
 
 function toto () {
-  var f = (i) => arguments[0] + i;
+  var f = (i) => arguments[0] + i;
   // lien implicite avec arguments de toto
   return f(2);
 }
 
-toto(3); // 5
+toto(3); // 5 +``` -

Les fonctions fléchées n’ont donc pas leur propre objet arguments, mais dans la plupart des cas, les paramètres du reste représentent une bonne alternative :

+Les fonctions fléchées n’ont donc pas leur propre objet `arguments`, mais dans la plupart des cas, [les paramètres du reste](/fr/docs/Web/JavaScript/Reference/Fonctions/paramètres_du_reste) représentent une bonne alternative : -
function toto () {
-  var f = (...args) => args[0];
+```js
+function toto () {
+  var f = (...args) => args[0];
   return f(2);
 }
 
-toto(1); // 2
+toto(1); // 2 +``` -

Les fonctions fléchées comme méthodes

+#### Les fonctions fléchées comme méthodes -

Comme indiqué précédemment, les fonctions fléchées sont mieux indiquées pour les fonctions qui ne sont pas des méthodes. Prenons un exemple pour illustrer ce point

+Comme indiqué précédemment, les fonctions fléchées sont mieux indiquées pour les fonctions qui ne sont pas des méthodes. Prenons un exemple pour illustrer ce point -
'use strict';
+```js
+'use strict';
 var objet = {
   i: 10,
-  b: () => console.log(this.i, this),
+  b: () => console.log(this.i, this),
   c: function() {
     console.log(this.i, this);
   }
@@ -217,95 +226,106 @@ objet.b();
 // affiche undefined, Window (ou l'objet global de l'environnement)
 
 objet.c();
-// affiche 10, Object {...}
+// affiche 10, Object {...} +``` -

Utiliser prototype

+#### Utiliser `prototype` -

Les fonctions fléchées ne possèdent pas de prototype :

+Les fonctions fléchées ne possèdent pas de prototype : -
var Toto = () => {};
+```js
+var Toto = () => {};
 console.log(Toto.prototype);
-
+``` -

Utiliser le mot-clé yield

+#### Utiliser le mot-clé `yield` -

Le mot-clé yield ne peut pas être utilisé dans le corps d’une fonction fléchée (sauf si cela intervient dans une autre fonction, imbriquée dans la fonction fléchée). De fait, les fonctions fléchéees ne peuvent donc pas être utilisées comme générateurs.

+Le mot-clé [`yield`](/fr/docs/Web/JavaScript/Reference/Op%C3%A9rateurs/yield) ne peut pas être utilisé dans le corps d’une fonction fléchée (sauf si cela intervient dans une autre fonction, imbriquée dans la fonction fléchée). De fait, les fonctions fléchéees ne peuvent donc pas être utilisées comme générateurs. -

Utiliser le mot-clé new

+#### Utiliser le mot-clé `new` -

Les fonctions fléchées ne peuvent pas être utilisées comme constructeurs et lèveront une exception si elles sont utilisées avec le mot-clé new.

+Les fonctions fléchées ne peuvent pas être utilisées comme constructeurs et lèveront une exception si elles sont utilisées avec le mot-clé `new`. -
var Toto = () => {};
+```js
+var Toto = () => {};
 var toto = new Toto();
-// TypeError: Toto is not a constructor
+// TypeError: Toto is not a constructor +``` -

Gestion du corps de la fonction

+## Gestion du corps de la fonction -

Les fonctions fléchées peuvent avoir une syntaxe concise ou utiliser un bloc d’instructions classique. Cette dernière syntaxe n’a pas de valeur de retour implicite et il faut donc employer l’instruction return.

+Les fonctions fléchées peuvent avoir une syntaxe concise ou utiliser un bloc d’instructions classique. Cette dernière syntaxe n’a pas de valeur de retour implicite et il faut donc employer l’instruction `return`. -
// méthode concise, retour implicite
-var fonction = x => x * x;
+```js
+// méthode concise, retour implicite
+var fonction = x => x * x;
 
 // bloc classique, retour explicite
-var fonction = (x, y) => { return x + y; }
-
+var fonction = (x, y) => { return x + y; } +``` -

Renvoyer des littéraux objets

+## Renvoyer des littéraux objets -

Attention à bien utiliser les parenthèses lorsqu’on souhaite renvoyer des objets avec des littéraux :

+Attention à bien utiliser les parenthèses lorsqu’on souhaite renvoyer des objets avec des littéraux : -
// fonction() renverra undefined !
-var fonction = () => { toto: 1 };
+```js
+// fonction() renverra undefined !
+var fonction = () => { toto: 1 };
 
 // SyntaxError
-var fonction2 = () =>  { toto: function () {} };
-
+var fonction2 = () => { toto: function () {} }; +``` -

En effet, ici, l’analyse de l’expression trouve des blocs d’instructions au lieu de littéraux objets. Pour éviter cet effet indésirable, on pourra encadrer le littéral objet :

+En effet, ici, l’analyse de l’expression trouve des blocs d’instructions au lieu de littéraux objets. Pour éviter cet effet indésirable, on pourra encadrer le littéral objet : -
var fonction = () => ({ toto: 1 });
+```js +var fonction = () => ({ toto: 1 }); +``` -

Sauts de ligne

+## Sauts de ligne -

Il ne peut pas y avoir de saut de ligne entre les paramètres et la flèche d’une fonction fléchée.

+Il ne peut pas y avoir de saut de ligne entre les paramètres et la flèche d’une fonction fléchée. -
var func = ()
-            => 1; // SyntaxError: expected expression,
-                  //              got '=>'
-
+```js +var func = () + => 1; // SyntaxError: expected expression, + // got '=>' +``` -

Ordre syntaxique

+## Ordre syntaxique -

La flèche utilisée pour une fonction fléchée n’est pas un opérateur. Les fonctions fléchées ont des règles spécifiques quant à leur place dans la syntaxe et interagissent différemment de la précédence des opérateurs par rapport à une fonction classique :

+La flèche utilisée pour une fonction fléchée n’est pas un opérateur. Les fonctions fléchées ont des règles spécifiques quant à leur place dans la syntaxe et interagissent différemment de la précédence des opérateurs par rapport à une fonction classique : -
let fonctionRappel;
+```js
+let fonctionRappel;
 
 fonctionRappel = fonctionRappel || function () {};
 // OK
 
-fonctionRappel = fonctionRappel || () => {};
+fonctionRappel = fonctionRappel || () => {};
 // SyntaxError: invalid arrow-function arguments
 
-fonctionRappel = fonctionRappel || (() => {});
+fonctionRappel = fonctionRappel || (() => {});
 // OK
-
+``` -

Exemples

+## Exemples -
// Une fonction fléchée vide renvoie undefined
-let vide = () => {};
+```js
+// Une fonction fléchée vide renvoie undefined
+let vide = () => {};
 
-(() => "tototruc")()
+(() => "tototruc")()
 // exemple d'une fonction immédiatement
 // invoquée (IIFE en anglais) qui renvoie
 // "tototruc"
 
-var simple = a => a > 15 ? 15 : a;
+var simple = a => a > 15 ? 15 : a;
 simple(16); // 15
 simple(10); // 10
 
-var complexe = (a, b) => {
-    if (a > b) {
+var complexe = (a, b) => {
+    if (a > b) {
         return a;
     } else {
         return b;
@@ -314,61 +334,44 @@ var complexe = (a, b) => {
 
 var arr = [5, 6, 13, 0, 1, 18, 23];
 
-var sum = arr.reduce((a, b) => a + b);
+var sum = arr.reduce((a, b) => a + b);
 // 66
 
-var even = arr.filter(v => v % 2 == 0);
+var even = arr.filter(v => v % 2 == 0);
 // [6, 0, 18]
 
-var double = arr.map(v => v * 2);
+var double = arr.map(v => v * 2);
 // [10, 12, 26, 0, 2, 36, 46]
 
 // On peut aussi construire des chaînes
 // de promesses plus concises
-promise.then(a => {
+promise.then(a => {
     // ...
-}).then(b => {
+}).then(b => {
     // ...
 });
 
 // Cela permet de visualiser les
 // fonctions sans paramètres
-setTimeout( () => {
+setTimeout( () => {
     console.log("Et voilà");
-    setTimeout( () => {
+    setTimeout( () => {
         console.log("ensuite…");
     }, 1);
 }, 1);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('ES2015', '#sec-arrow-function-definitions', 'Arrow Function Definitions')}}{{Spec2('ES2015')}}Définition initiale.
{{SpecName('ESDraft', '#sec-arrow-function-definitions', 'Arrow Function Definitions')}}{{Spec2('ESDraft')}}
- -

Compatibilité des navigateurs

- -

{{Compat("javascript.functions.arrow_functions")}}

- -

Voir aussi

- - +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------------------------------- | ---------------------------- | -------------------- | +| {{SpecName('ES2015', '#sec-arrow-function-definitions', 'Arrow Function Definitions')}} | {{Spec2('ES2015')}} | Définition initiale. | +| {{SpecName('ESDraft', '#sec-arrow-function-definitions', 'Arrow Function Definitions')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.functions.arrow_functions")}} + +## Voir aussi + +- L’article sur les fonctions fléchées présent sur [https ://tech.mozfr.org](https://tech.mozfr.org) (l’article original en anglais est disponible [ici](https://hacks.mozilla.org/2015/06/es6-in-depth-arrow-functions/)). -- cgit v1.2.3-54-g00ecf