CKTIS / JavaScript
Déstructuration de tableau dans les paramètres de fonction
Un motif de tableau dans la liste des paramètres décompose un seul argument itérable. Les valeurs par défaut de l’argument et de ses éléments sont distinctes.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
function f([first = 1, , third = 3, ...rest] = []) { /* function body */ }Dans la liste des paramètres, [first, third] est un motif de liaison de tableau qui décompose un seul argument, et non deux paramètres distincts. Lors de l’appel, le motif initialise les noms locaux dans l’ordre d’itération, avant l’exécution du corps de la fonction. Un tableau convient, tout comme un autre itérable tel qu’un Set ; un objet ordinaire doté de clés numériques et d’une propriété length ne suffit pas.
Dans [first = 1, , third = 3, ...rest], l’emplacement vide entre les virgules ignore la deuxième valeur. ...rest rassemble les valeurs restantes dans un nouveau tableau. C’est un élément de reste du motif, pas un paramètre du reste qui rassemble des arguments distincts de l’appel. Il doit être placé en dernier, sans virgule après lui.
Le = [] extérieur remplace l’argument entier uniquement s’il est omis ou vaut undefined. Les valeurs par défaut internes = 1 et = 3 s’appliquent si la valeur correspondante manque ou vaut undefined. Un null dans le tableau reste null. Passer null ou une autre valeur non itérable comme argument entier déclenche une TypeError avant l’exécution du corps. Sans = [], omettre l’argument ou passer undefined déclenche aussi une TypeError.
Exemples
function describe([first = 1, , third = 3, ...rest] = []) {
return [first, third, rest];
}
console.log(JSON.stringify(describe()));
console.log(JSON.stringify(describe([undefined, 20, null, 40, 50])));
console.log(JSON.stringify(describe(new Set([10, 20, 30]))));
try {
describe(null);
} catch (error) {
console.log(error.name);
}Résultat
[1,3,[]] [1,null,[40,50]] [10,30,[]] TypeError
Le premier appel utilise les deux niveaux de valeurs par défaut. Dans le deuxième, `20` est ignoré, `null` est conservé et `rest` vaut `[40,50]`. Le troisième montre qu’un `Set` convient aussi. Le dernier affiche le nom de l’erreur plutôt qu’un message propre à l’environnement d’exécution.
Leçons associées
- JavaScript · Leçon 28 · Intermédiaire · Version : 3