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

CKTIS / JavaScript

Déstructuration d’objet, paramètres par défaut et notation abrégée des propriétés

Lisez des options dans un seul argument, distinguez la valeur par défaut du paramètre entier de celles des propriétés et construisez le résultat avec la notation abrégée.

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

Syntaxe

function configure({ limit: maxItems = 10, enabled = true } = {}) {
  return { maxItems, enabled };
}

Dans la signature de configure, { limit: maxItems = 10, enabled = true } est un motif de déstructuration. La fonction reçoit un seul argument positionnel, et non des arguments nommés. Le motif lit limit dans la variable locale maxItems et enabled dans une variable du même nom.

Le = {} extérieur crée un nouvel objet vide lorsque l’argument est omis ou vaut explicitement undefined. Les valeurs par défaut internes = 10 et = true s’appliquent indépendamment, uniquement si la lecture de la propriété correspondante donne undefined, notamment si aucune propriété n’est trouvée. Les valeurs de propriété null, 0, false et "" sont conservées. En revanche, configure(null) lève une TypeError avant l’exécution du corps de la fonction. Sans le = {} extérieur, omettre l’argument lèverait aussi une TypeError.

Les expressions par défaut sont évaluées à l’appel, uniquement si nécessaire. Elles peuvent utiliser les paramètres précédents déjà initialisés, mais pas les déclarations du corps de la fonction. La lecture d’une propriété peut parcourir la chaîne de prototypes ou appeler un accesseur en lecture. Le motif ne vérifie donc ni le type de la valeur ni si la propriété appartient directement à l’objet.

Dans return { maxItems, enabled }, les accolades délimitent un littéral qui crée un nouvel objet, et non un motif. La notation abrégée a ici le même effet que { maxItems: maxItems, enabled: enabled } : les clés reprennent les noms locaux, donc le résultat contient la clé maxItems, et non limit. Cette syntaxe figure dans ECMAScript 2024 ; vérifiez sa prise en charge dans les anciens environnements d’exécution que vous ciblez.

Exemples

function configure({ limit: maxItems = 10, enabled = true } = {}) {
  return { maxItems, enabled };
}

console.log(JSON.stringify(configure()));
console.log(JSON.stringify(configure(undefined)));
console.log(JSON.stringify(configure({ limit: 0, enabled: false })));
console.log(JSON.stringify(configure({ limit: undefined, enabled: null })));

try {
  configure(null);
} catch (error) {
  console.log(error.name);
}

Résultat

{"maxItems":10,"enabled":true}
{"maxItems":10,"enabled":true}
{"maxItems":0,"enabled":false}
{"maxItems":10,"enabled":null}
TypeError

Les deux premiers appels donnent le même résultat. Le troisième conserve `0` et `false`, le quatrième remplace uniquement `undefined` et le dernier affiche `TypeError`, car l’argument entier vaut `null`.

Leçons associées

  • JavaScript · Leçon 42 · Avancé · Version : 4

Sources