CKTIS / JavaScript
Syntaxe des paramètres par défaut
Dans une définition de fonction, `paramètre = expression` fournit une valeur lorsque l’argument correspondant est omis ou vaut explicitement `undefined`.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
function f(a, b = a) { /* ... */ }
const g = (a, b = a) => b;
function h({ x = 1 } = {}) { return x; }Écris paramètre = expression dans la liste des paramètres d’une fonction, d’une méthode ou d’une fonction fléchée. La valeur par défaut ne s’applique que si l’argument à cette position est omis ou vaut undefined. null, false, 0 et "" restent inchangés. Pour utiliser la valeur par défaut à une position tout en fournissant un argument à une position suivante, passe undefined à la première position concernée.
Les paramètres sont initialisés de gauche à droite avant l’exécution du corps de la fonction. Une expression d’initialisation est évaluée à chaque appel qui en a besoin : items = [] crée donc un nouveau tableau chaque fois que cette valeur par défaut est utilisée. Elle peut lire un paramètre précédent, mais lire un paramètre suivant avant son initialisation déclenche une ReferenceError. Les déclarations du corps de la fonction ne sont pas visibles depuis les expressions d’initialisation des paramètres.
Dans function h({ x = 1 } = {}) { return x; }, le = {} extérieur s’applique si l’argument est omis ou vaut undefined. Le x = 1 intérieur s’applique si la propriété x est absente ou vaut undefined. h(null) déclenche une TypeError : la valeur par défaut extérieure ne remplace pas null, et on ne peut pas déstructurer null.
Un paramètre sans valeur par défaut peut suivre un paramètre qui en a une, mais il n’est pas compté dans length. Cette propriété compte seulement les paramètres qui précèdent le premier initialiseur portant sur un paramètre entier et exclut toujours le paramètre du reste. Ce dernier ne peut pas avoir d’initialiseur.
Exemples
{
function collect(value, label = value, items = []) {
items.push(label);
return items;
}
console.log(JSON.stringify(collect("A")));
console.log(JSON.stringify(collect("B", undefined)));
console.log(JSON.stringify(collect("C", null)));
console.log(JSON.stringify(collect("D", false, ["start"])));
console.log(String(collect.length));
}Résultat
["A"] ["B"] [null] ["start",false] 1
Omettre `label` ou passer `undefined` fait utiliser `value`, mais `null` et `false` sont conservés. Les trois premiers appels créent chacun un tableau distinct ; le quatrième ajoute un élément au tableau fourni. `collect.length` vaut `1`, car seul `value` est compté.
Leçons associées
- JavaScript · Leçon 21 · Avancé · Version : 4
- JavaScript · Leçon 27 · Avancé · Version : 4
- JavaScript · Leçon 29 · Avancé · Version : 4
- JavaScript · Leçon 44 · Avancé · Version : 4
- JavaScript · Leçon 45 · Avancé · Version : 4