diff options
author | julieng <julien.gattelier@gmail.com> | 2021-08-03 08:03:23 +0200 |
---|---|---|
committer | SphinxKnight <SphinxKnight@users.noreply.github.com> | 2021-09-03 08:08:25 +0200 |
commit | bf8e099b9c8b3c60d60b3712b4fc97b052c39887 (patch) | |
tree | c101746d082c9581c94f5937519c7d0e2f4af8cb /files/fr/web/javascript/reference/functions/default_parameters | |
parent | 844f5103992238c0c23203286dad16a466e89c97 (diff) | |
download | translated-content-bf8e099b9c8b3c60d60b3712b4fc97b052c39887.tar.gz translated-content-bf8e099b9c8b3c60d60b3712b4fc97b052c39887.tar.bz2 translated-content-bf8e099b9c8b3c60d60b3712b4fc97b052c39887.zip |
convert content to md
Diffstat (limited to 'files/fr/web/javascript/reference/functions/default_parameters')
-rw-r--r-- | files/fr/web/javascript/reference/functions/default_parameters/index.md | 158 |
1 files changed, 75 insertions, 83 deletions
diff --git a/files/fr/web/javascript/reference/functions/default_parameters/index.md b/files/fr/web/javascript/reference/functions/default_parameters/index.md index abcdcae567..92a5187cf6 100644 --- a/files/fr/web/javascript/reference/functions/default_parameters/index.md +++ b/files/fr/web/javascript/reference/functions/default_parameters/index.md @@ -9,28 +9,26 @@ tags: translation_of: Web/JavaScript/Reference/Functions/Default_parameters original_slug: Web/JavaScript/Reference/Fonctions/Valeurs_par_défaut_des_arguments --- -<div>{{jsSidebar("Functions")}}</div> +{{jsSidebar("Functions")}} -<p>Cette syntaxe permet d'initialiser des paramètres lors de l'appel de la fonction si aucune valeur n'est passée ou si c'est la valeur {{jsxref("undefined")}} qui est passée.</p> +Cette syntaxe permet d'initialiser des paramètres lors de l'appel de la fonction si aucune valeur n'est passée ou si c'est la valeur {{jsxref("undefined")}} qui est passée. +{{EmbedInteractiveExample("pages/js/functions-default.html")}} +## Syntaxe -<div>{{EmbedInteractiveExample("pages/js/functions-default.html")}}</div> + function [nom]([param1[ = valeurParDéfaut1 ][, ..., paramN[ = valeurParDéfautN ]]]) { + instructions + } -<h2 id="Syntaxe">Syntaxe</h2> +## Description -<pre class="syntaxbox">function [<em>nom</em>]([<em>param1</em>[ = valeurParDéfaut1 ][, ..., <em>paramN</em>[ = valeurParDéfautN ]]]) { - instructions -} -</pre> - -<h2 id="Description">Description</h2> - -<p>En JavaScript, par défaut, la valeur des paramètres d'une fonction sera <code>undefined</code>. Malgré tout, il peut être assez utile de pouvoir définir d'autres valeurs par défaut.</p> +En JavaScript, par défaut, la valeur des paramètres d'une fonction sera `undefined`. Malgré tout, il peut être assez utile de pouvoir définir d'autres valeurs par défaut. -<p>Auparavant, pour définir une valeur par défaut pour un paramètre, il fallait tester s'il valait <code>undefined</code> et lui affecter une valeur choisie le cas échéant. Dans l'exemple qui suit, le paramètre <code>b</code> n'a pas de valeur fournie lors de l'appel, aussi si on avait utilisé <code>undefined</code> dans la multiplication, la valeur retournée aurait été <code>NaN</code>. Aussi, dans la deuxième ligne du code, on prévoit ce cas :</p> +Auparavant, pour définir une valeur par défaut pour un paramètre, il fallait tester s'il valait `undefined` et lui affecter une valeur choisie le cas échéant. Dans l'exemple qui suit, le paramètre `b` n'a pas de valeur fournie lors de l'appel, aussi si on avait utilisé `undefined` dans la multiplication, la valeur retournée aurait été `NaN`. Aussi, dans la deuxième ligne du code, on prévoit ce cas : -<pre class="brush: js">function multiplier(a, b) { +```js +function multiplier(a, b) { var b = (typeof b !== 'undefined') ? b : 1; return a * b; @@ -39,26 +37,29 @@ original_slug: Web/JavaScript/Reference/Fonctions/Valeurs_par_défaut_des_argume multiplier(5, 2); // 10 multiplier(5, 1); // 5 multiplier(5); // 5 -</pre> +``` -<p>Grâce aux paramètres par défaut qui existent depuis ECMAScript 2015 (ES6), on peut se passer de cette vérification et alléger le code de la fonction :</p> +Grâce aux paramètres par défaut qui existent depuis ECMAScript 2015 (ES6), on peut se passer de cette vérification et alléger le code de la fonction : -<pre class="brush: js">function multiplier(a, b = 1) { +```js +function multiplier(a, b = 1) { return a * b; } multiplier(5, 2); // 10 multiplier(5, 1); // 5 multiplier(5, undefined); // 5 -multiplier(5); // 5</pre> +multiplier(5); // 5 +``` -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Passer_undefined_en_paramètre">Passer <code>undefined</code> en paramètre</h3> +### Passer `undefined` en paramètre -<p>Dans l'exemple qui suit, le deuxième appel à la fonction fait explicitement appel à <code>undefined</code>. La valeur par défaut sera utilisée, y compris dans ce cas (en revanche, ce ne serait pas vrai pour <code>null</code> ou les autres valeurs équivalentes à <code>false</code> dans un contexte booléen).</p> +Dans l'exemple qui suit, le deuxième appel à la fonction fait explicitement appel à `undefined`. La valeur par défaut sera utilisée, y compris dans ce cas (en revanche, ce ne serait pas vrai pour `null` ou les autres valeurs équivalentes à `false` dans un contexte booléen). -<pre class="brush: js">function test(num = 1) { +```js +function test(num = 1) { console.log(typeof num); } @@ -66,38 +67,40 @@ test(); // number (num vaut 1) test(undefined); // number (num vaut 1 également) test(""); // string (num vaut "") test(null); // object (num vaut null) -</pre> +``` -<h3 id="Évaluation_à_l'appel">Évaluation à l'appel</h3> +### Évaluation à l'appel -<p>L'argument par défaut est évalué à l'instant de l'appel. Ainsi, à la différence d'autres langages comme Python, un nouvel objet est créé à chaque appel de la fonction.</p> +L'argument par défaut est évalué à l'instant de l'appel. Ainsi, à la différence d'autres langages comme Python, un nouvel objet est créé à chaque appel de la fonction. -<pre class="brush: js">function append(valeur, tableau = []) { +```js +function append(valeur, tableau = []) { tableau.push(valeur); return tableau; } append(1); //[1] append(2); //[2], et non [1, 2] +``` -</pre> +Cela est également valable pour les fonctions et les variables -<p>Cela est également valable pour les fonctions et les variables</p> - -<pre class="brush: js">function appelQqc(truc = qqc()) { return truc } +```js +function appelQqc(truc = qqc()) { return truc } appelQqc(); //lève une ReferenceError -let qqc = () => "machin" +let qqc = () => "machin" appelQqc(); // "machin" -</pre> +``` -<h3 id="Les_paramètres_par_défaut_sont_disponibles_à_la_suite">Les paramètres par défaut sont disponibles à la suite</h3> +### Les paramètres par défaut sont disponibles à la suite -<p>Les paramètres déjà rencontrés dans la définition peuvent être utilisés comme paramètres par défaut dans la suite de la définition :</p> +Les paramètres déjà rencontrés dans la définition peuvent être utilisés comme paramètres par défaut dans la suite de la définition : -<pre class="brush: js">function salutation(nom, salut, message = salut + ' ' + nom){ +```js +function salutation(nom, salut, message = salut + ' ' + nom){ return [nom, salut, message]; } @@ -105,11 +108,13 @@ salutation('David', 'Coucou'); // ["David", "Coucou", "Coucou David"] salutation('David', 'Coucou', 'Bon anniversaire !'); -// ["David", "Coucou", "Bon anniversaire !"]</pre> +// ["David", "Coucou", "Bon anniversaire !"] +``` -<p>On peut utiliser cette fonctionnalité afin de gérer beaucoup de cas aux limites :</p> +On peut utiliser cette fonctionnalité afin de gérer beaucoup de cas aux limites : -<pre class="brush: js">function go() { +```js +function go() { return ":P" } @@ -144,68 +149,55 @@ avecDéfaut.call({value:"=^_^="}); sansDéfaut.call({value:"=^_^="}); // [undefined, 5, 5, ":P", {value:"=^_^="}, arguments, "=^_^="] -</pre> +``` -<h3 id="Les_fonctions_définies_dans_le_corps_d'une_fonction">Les fonctions définies dans le corps d'une fonction</h3> +### Les fonctions définies dans le corps d'une fonction -<p>À partir de Gecko 33 {{geckoRelease(33)}}. Les fonctions déclarées dans le corps de la fonction ne peuvent pas servir comme valeurs par défaut, cela lèvera une exception {{jsxref("ReferenceError")}} (plus précisément une {{jsxref("TypeError")}} avec SpiderMonkey, voir le {{bug(1022967)}}). Les paramètres par défaut sont exécutés en premier, les déclarations de fonctions présentes dans le corps de la fonction sont évaluées ensuite.</p> +À partir de Gecko 33 {{geckoRelease(33)}}. Les fonctions déclarées dans le corps de la fonction ne peuvent pas servir comme valeurs par défaut, cela lèvera une exception {{jsxref("ReferenceError")}} (plus précisément une {{jsxref("TypeError")}} avec SpiderMonkey, voir le {{bug(1022967)}}). Les paramètres par défaut sont exécutés en premier, les déclarations de fonctions présentes dans le corps de la fonction sont évaluées ensuite. -<pre class="brush: js">// Ne fonctionnera pas, entraîne une ReferenceError. +```js +// Ne fonctionnera pas, entraîne une ReferenceError. function f(a = go()) { function go(){return ":P"} } -</pre> +``` -<h3 id="Utilisation_de_paramètres_sans_valeur_par_défaut_après_les_paramètres_par_défaut">Utilisation de paramètres sans valeur par défaut après les paramètres par défaut</h3> +### Utilisation de paramètres sans valeur par défaut après les paramètres par défaut -<p>Avant Gecko 26 ({{geckoRelease(26)}}, le code suivant aurait entraîné une exception {{jsxref("SyntaxError")}}. Cela a été corrigé avec le bug {{bug(777060)}}. Les paramètres sont toujours ordonnés de gauche à droite et les valeurs par défaut sont surchargées s'ils viennent avant les autres paramètres :</p> +Avant Gecko 26 ({{geckoRelease(26)}}, le code suivant aurait entraîné une exception {{jsxref("SyntaxError")}}. Cela a été corrigé avec le bug {{bug(777060)}}. Les paramètres sont toujours ordonnés de gauche à droite et les valeurs par défaut sont surchargées s'ils viennent avant les autres paramètres : -<pre class="brush: js">function f(x=1, y) { +```js +function f(x=1, y) { return [x, y]; } f(); // [1, undefined] f(2); // [2, undefined] -</pre> +``` -<h3 id="Paramètre_par_défaut_et_décomposition_des_paramètres">Paramètre par défaut et décomposition des paramètres</h3> +### Paramètre par défaut et décomposition des paramètres -<p>Il est possible d'utiliser les valeurs par défaut avec <a href="/fr/docs/Web/JavaScript/Reference/Opérateurs/Affecter_par_décomposition">la syntaxe de décomposition</a> :</p> +Il est possible d'utiliser les valeurs par défaut avec [la syntaxe de décomposition](/fr/docs/Web/JavaScript/Reference/Opérateurs/Affecter_par_décomposition) : -<pre class="brush: js">function f([x, y] = [1, 2], {z: z} = {z: 3}) { +```js +function f([x, y] = [1, 2], {z: z} = {z: 3}) { return x + y + z; } -f(); // 6</pre> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">État</th> - <th scope="col">Commentaires</th> - </tr> - <tr> - <td>{{SpecName('ES2015', '#sec-function-definitions', 'Function Definitions')}}</td> - <td>{{Spec2('ES2015')}}</td> - <td>Définition initiale.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-function-definitions', 'Function Definitions')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.functions.default_parameters")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="https://wiki.ecmascript.org/doku.php?id=harmony:parameter_default_values">La proposition originale sur ecmascript.org</a></li> -</ul> +f(); // 6 +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ---------------------------------------------------------------------------------------------------- | ---------------------------- | -------------------- | +| {{SpecName('ES2015', '#sec-function-definitions', 'Function Definitions')}} | {{Spec2('ES2015')}} | Définition initiale. | +| {{SpecName('ESDraft', '#sec-function-definitions', 'Function Definitions')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.functions.default_parameters")}} + +## Voir aussi + +- [La proposition originale sur ecmascript.org](https://wiki.ecmascript.org/doku.php?id=harmony:parameter_default_values) |