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

CKTIS / JavaScript

Déstructurer des objets et des valeurs itérables

La déstructuration lit les propriétés d’un objet ou les valeurs successives d’un objet itérable à l’aide d’un motif. Elle permet de déclarer des variables, d’affecter des valeurs à des variables existantes, de renommer des liaisons, de définir des valeurs par défaut et de recueillir les valeurs ou propriétés restantes.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

const { key: localName = fallback, ...rest } = object;
const [first, , third = fallback, ...tail] = iterable;
({ key: existingVariable } = object);

La déstructuration (destructuring) est une syntaxe de motif, et non une fonction ou un mot-clé. Un motif objet comme { key } lit une propriété à partir de sa clé, tandis que [first] consomme une valeur d’un itérateur : la source n’a pas besoin d’être un tableau. Les motifs peuvent être imbriqués et utilisés dans les paramètres de fonction.

La déclaration const { key: localName = fallback } = object crée localName, et non key. Une valeur par défaut n’est évaluée que si la valeur extraite est undefined, y compris lorsque la propriété est absente ; null, 0 et false ne la déclenchent pas. Déstructurer null ou undefined déclenche une TypeError ; un motif tableau exige une valeur itérable.

Une virgule dans un motif tableau permet d’ignorer une position. Un ...tail final recueille les valeurs restantes de l’itérateur dans un nouveau tableau ; ...rest dans un motif objet copie les propriétés propres énumérables restantes dans un nouvel objet. Rest doit être le dernier élément et ne peut pas être suivi d’une virgule. Il ne s’agit pas d’une copie profonde : les objets imbriqués restent des références partagées.

Une déclaration crée des liaisons, tandis qu’une affectation met à jour des cibles existantes. Lorsqu’une affectation d’objet commence une instruction, utilisez des parenthèses : ({ key: existingVariable } = object);, afin que { ne commence pas un bloc. Dans l’exemple, userName reçoit "Ada" et les valeurs undefined déclenchent les valeurs par défaut.

Exemples

const record = { name: "Ada", score: undefined, active: true };
const { name: userName, score = 10, ...rest } = record;
const [first, , third = 9, ...tail] = [2, 4, undefined, 8];
console.log(`${userName}|${score}|${rest.active}|${first}|${third}|${tail.join(",")}`);

Résultat

Ada|10|true|2|9|8

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources