Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Déstructuration des paramètres de fonction

Placez un motif directement dans la liste des paramètres pour lire des propriétés d’objet ou des valeurs d’un itérable. Distinguez les valeurs par défaut du paramètre entier de celles du motif.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

function readOptions({ label: name = "untitled" } = {}) { return name; }
function readFirst([count = 1] = []) { return count; }

Déstructurer un paramètre consiste à écrire un motif de liaison directement dans la liste des paramètres de la fonction. Pour un paramètre ordinaire, le motif utilise la valeur correspondant à une seule position d’argument et crée des liaisons locales accessibles dans le corps de la fonction. Un paramètre du reste (...) peut aussi utiliser un motif de liaison, mais celui-ci déstructure alors le tableau qui contient les arguments restants. Les arguments restent positionnels, et non nommés.

Le motif d’objet { label } lit la propriété par son nom et crée une liaison locale label. Avec { label: name }, on lit la même propriété, mais sa valeur est liée au nom local name. Le motif de tableau [count] prend la première valeur dans l’ordre d’itération, qu’elle provienne d’un tableau ou d’un autre itérable.

Les valeurs par défaut externes = {} et = [] remplacent l’argument entier avant la déstructuration, uniquement s’il est omis ou vaut undefined. Les valeurs par défaut internes, comme dans name = "untitled" et count = 1, ne s’appliquent que si la valeur extraite est undefined, par exemple si une propriété est absente ou si l’itérateur ne fournit plus de valeur. null, 0, false et "" ne déclenchent pas ces valeurs par défaut.

Passer null comme argument entier à l’un ou l’autre motif déclenche une TypeError avant l’exécution du corps de la fonction. Sans valeur par défaut externe, omettre l’argument ou passer undefined provoque la même erreur. Un motif de tableau déclenche aussi une TypeError si la valeur n’est pas itérable. La déstructuration ne remplace pas la validation des entrées.

Exemples

function describe({ label: name = "untitled" } = {}, [count = 1] = []) {
  return `${name}: ${count}`;
}

console.log(describe());
console.log(describe({ label: "draft" }, [0]));
console.log(describe({ label: null }, []));

Résultat

untitled: 1
draft: 0
null: 1

Le premier appel utilise les deux niveaux de valeurs par défaut. Le deuxième conserve `0`. Dans le troisième, `label` vaut `null` et n’est pas remplacé, tandis que le tableau vide déclenche `count = 1`.

Leçons associées

  • JavaScript · Leçon 2 · Intermédiaire · Version : 3

Sources