CKTIS / JavaScript
Paramètre de fonction avec décomposition de tableau
Extrayez les valeurs d’un seul argument itérable dans la signature d’une fonction et distinguez la valeur par défaut d’un élément de celle du paramètre entier.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
function describe([first = "default", , ...rest] = []) {
return JSON.stringify([first, rest]);
}Un motif de liaison de tableau comme [first, second], placé dans la liste des paramètres, décompose un seul argument avant l’exécution du corps de la fonction. Les noms first et second sont disponibles dans ce corps. Le motif lit les valeurs dans l’ordre d’itération : l’argument peut être un tableau ou un autre itérable, par exemple un Set. Un objet ordinaire doté d’indices numériques et d’une propriété length, mais sans itérateur, provoque une TypeError.
Dans [first = "default", , ...rest] = [], le = [] externe remplace un argument omis ou égal à undefined par un tableau vide. Le = "default" interne s’applique si l’itérateur ne fournit aucune première valeur ou fournit d’abord undefined. Passer null provoque une TypeError avant l’exécution du corps ; passer [null] lie first à null.
L’emplacement vide entre les virgules ignore la deuxième valeur. L’élément de reste ...rest rassemble toutes les valeurs restantes dans un nouveau tableau. Il doit être le dernier élément du motif, sans virgule finale. Contrairement au paramètre du reste dans function f(...args) {}, il rassemble les valeurs d’un seul argument, et non les arguments restants de l’appel.
Exemples
function describe([first = "default", , ...rest] = []) {
return JSON.stringify([first, rest]);
}
console.log(describe());
console.log(describe(["A", "skip", "B", "C"]));
console.log(describe(new Set([undefined, "skip", "Z"])));
console.log(describe([null]));Résultat
["default",[]] ["A",["B","C"]] ["default",["Z"]] [null,[]]
Le premier appel utilise les deux valeurs par défaut. Le deuxième ignore `"skip"` ; le troisième lit un `Set` et applique la valeur par défaut interne à `undefined`. Le quatrième conserve `null`.
Leçons associées
- JavaScript · Leçon 7 · Avancé · Version : 4