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}
TypeErrorLes 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