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

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