CKTIS / JavaScript
Déclaration par déstructuration d’objet
Une déclaration par déstructuration d’objet crée des liaisons de variables à partir des propriétés de la source. Le motif permet de choisir leurs noms, de définir des valeurs par défaut et de regrouper les propriétés restantes.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
const { property, key: local = fallback, [computedKey]: selected, nested: { inner } = {}, ...rest } = source;
let { property: mutable } = source;
var { property: variable } = source;Dans une déclaration ordinaire comme const { property } = source;, les accolades délimitent un motif de liaison, pas un littéral d’objet. L’expression source est l’initialiseur obligatoire. const et let ont une portée de bloc ; const interdit la réaffectation de la liaison, pas la modification de l’objet. Dans une fonction, var a une portée de fonction, non de bloc.
{ key: local } lit key et déclare local, pas key. { [computedKey]: selected } calcule la clé, et un motif imbriqué lit des propriétés au niveau suivant. Une expression par défaut n’est évaluée que si la lecture renvoie undefined, par exemple si la propriété est absente. Elle ne remplace ni null, ni false, ni 0. Déstructurer null ou undefined déclenche une TypeError, même dans un motif imbriqué.
Une propriété sélectionnée explicitement peut être héritée. ...rest effectue une copie superficielle des seules propriétés propres et énumérables restantes dans un nouvel objet, y compris celles dont la clé est un Symbol. Dans une déclaration, cet élément vient en dernier, lie un identifiant et ne peut pas être suivi d’une virgule. La déstructuration ne valide pas les données ; la lecture d’une propriété peut appeler un accesseur de lecture (getter).
({ property } = source); affecte une valeur à une variable existante au lieu de la déclarer. En début d’instruction, les parenthèses évitent que { soit interprété comme le début d’un bloc. ECMAScript 2024 définit cette syntaxe ; vérifiez sa prise en charge dans l’environnement d’exécution visé.
Exemples
{
const key = "theme";
const source = { name: "Ada", theme: null, active: false };
const {
name: displayName,
[key]: theme = "light",
settings: { density = "compact" } = {},
...rest
} = source;
console.log(JSON.stringify([displayName, theme, density, rest]));
}Résultat
["Ada",null,"compact",{"active":false}]`name` est lié à `displayName`, tandis que `theme` reste à `null`. L’absence de `settings` déclenche d’abord la valeur par défaut `{}`, puis `density` prend la valeur `"compact"`. Seule la propriété `active: false` reste dans `rest`.
Leçons associées
- JavaScript · Leçon 1 · Avancé · Version : 4
- JavaScript · Leçon 8 · Avancé · Version : 4
- JavaScript · Leçon 11 · Avancé · Version : 4
Sources
- ECMAScript 2024 Language Specification — Let and Const Declarations
- ECMAScript 2024 Language Specification — Variable Statement
- ECMAScript 2024 Language Specification — Destructuring Binding Patterns
- ECMAScript 2024 Language Specification — CopyDataProperties
- ECMAScript 2024 Language Specification — Destructuring Assignment
- MDN — Destructuring