CKTIS / JavaScript
Déstructuration d’objet
La déstructuration d’objet lit les propriétés par clé plutôt que par position. Elle permet de déclarer des variables, d’affecter des valeurs à des cibles existantes, 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 { name, theme: colorTheme = "light", ...rest } = profile;
let score;
({ points: score } = profile);
const { [key]: value, settings: { mode } = {} } = options;
function readName({ name = "Guest" } = {}) { return name; }La déstructuration d’objet utilise un motif entre {} pour lire des propriétés par clé. Dans const { name } = profile, la variable name reçoit la valeur de profile.name. Le motif { name: displayName } lit la même clé et place la valeur dans la variable displayName, sans renommer la propriété. Avec { [key]: value }, la clé est calculée ; { settings: { mode } } lit une propriété imbriquée et ne crée qu’une liaison pour mode.
Dans une déclaration avec const, let ou var, ou dans un paramètre de fonction, le motif crée des liaisons. L’affectation ({ points: score } = profile) écrit dans la variable existante score ; une propriété accessible en écriture peut aussi servir de cible. Dans une instruction autonome, les parenthèses empêchent que l’accolade ouvrante soit interprétée comme le début d’un bloc.
Dans { theme = "light" }, l’expression par défaut n’est évaluée que si la lecture renvoie undefined, par exemple si la propriété est introuvable. Les valeurs null, false et 0 sont conservées. Appliquer un motif d’objet à null ou à undefined déclenche une TypeError, même dans un motif imbriqué. Dans function readName({ name = "Guest" } = {}), la valeur par défaut du paramètre = {} s’applique si l’argument est omis ou vaut undefined, mais pas s’il vaut null.
La recherche d’une clé explicite peut trouver une propriété héritée. En revanche, ...rest ne copie que les propriétés propres énumérables restantes dans un nouvel objet, y compris celles dont la clé est un symbole. La copie est superficielle : les valeurs objets restent partagées. ...rest doit être en dernier, sans virgule finale.
C’est une syntaxe d’ECMAScript 2024, pas une API du navigateur. Pour les anciens environnements JavaScript, vérifiez la prise en charge des formes utilisées, notamment ...rest.
Exemples
{
const profile = { name: "Mira", theme: undefined, badge: null, points: 7 };
const { name: displayName, theme = "light", badge = "none", ...rest } = profile;
let score;
({ points: score } = profile);
console.log(`${displayName} | ${theme} | ${badge} | ${score} | ${Object.keys(rest).join(",")}`);
}Résultat
Mira | light | null | 7 | points
`displayName` reçoit la valeur de `name`, `theme` prend sa valeur par défaut et `badge` reste à `null`. L’affectation écrit `7` dans `score` ; `points` est l’unique clé de `rest`.
Leçons associées
- JavaScript · Leçon 39 · Avancé · Version : 4
- JavaScript · Leçon 5 · Débutant · Version : 4
- JavaScript · Leçon 18 · Débutant · Version : 4
- JavaScript · Leçon 2 · Intermédiaire · Version : 3
- JavaScript · Leçon 8 · Intermédiaire · Version : 3
- JavaScript · Leçon 10 · Intermédiaire · Version : 3