Formations — 1 037 leçons en français

Accueil › JavaScript › Déstructurer un objet

Déstructurer un objet

Les objetsdebutant

Extraire par nom

const client = { nom: "Dupont", prenom: "Jean", age: 42 };

const { nom, age } = client;
// nom vaut "Dupont", age vaut 42

Contrairement aux tableaux, c'est le nom qui compte, pas l'ordre. On peut n'extraire qu'une partie, dans n'importe quel ordre.

Renommer

const { nom: nomClient } = client;
// nomClient vaut "Dupont" ; « nom » n'existe pas comme variable

À gauche la propriété, à droite la variable. Utile quand le nom entre en conflit avec une variable existante.

Valeur par défaut

const { ville = "inconnue" } = client;     // "inconnue" — absente

Elle se déclenche pour une propriété absente ou undefined. Pas pour null, pas pour 0, pas pour "".

Le reste

const { id, ...reste } = { id: 1, nom: "a", actif: true };
// id vaut 1, reste vaut { nom: "a", actif: true }

C'est la façon de retirer un champ sans toucher à l'original — utile pour ne pas renvoyer un mot de passe, par exemple.

Dans les paramètres

function afficher({ nom, age = 0 }) {
  return `${nom}, ${age} ans`;
}

afficher({ nom: "Anne", age: 30 });

L'appelant passe un objet : l'ordre des arguments disparaît, et la signature se lit comme une liste de champs attendus.

Les termes à connaître

Déstructuration d'objet

Extraire des propriétés dans des variables en une ligne : const { nom, age } = client. Ce sont les noms qui comptent, pas l'ordre.

Renommage

Donner un autre nom à la variable extraite : const { nom: nomClient } = client. Les deux-points se lisent « sous le nom de ».

Valeur par défaut

Un repli quand la propriété est absente ou vaut undefined : const { ville = "inconnue" } = client.

Reste d'objet

const { id, ...reste } = o met toutes les autres propriétés dans un nouvel objet. Pratique pour retirer un champ sans mutation.

Déstructuration imbriquée

Descendre dans un objet contenu : const { adresse: { ville } } = client. Puissant, mais lève une erreur si adresse est absente.

Paramètre objet

Déstructurer directement dans la signature : function f({ nom, age }). L'appelant passe un objet, et l'ordre des arguments n'a plus d'importance.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.