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

CKTIS / JavaScript

Mises à jour immuables et partage structurel

Créez un nouvel état sans modifier le précédent : copiez les conteneurs sur le chemin de la modification et réutilisez les branches inchangées.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

const next = { ...state, profile: { ...state.profile, name: newName } };
const nextItems = items.with(index, replacement);

Une mise à jour immuable crée une nouvelle version de l’état sans modifier la précédente. Si l’état forme un arbre, créez de nouveaux conteneurs de la racine au point de modification et réutilisez les mêmes objets dans les branches inchangées. C’est le partage structurel. Pour les objets, === teste l’identité, pas l’égalité du contenu. Si rien ne change, vous pouvez renvoyer la racine d’origine.

Dans un littéral d’objet, la syntaxe de décomposition ... copie superficiellement les valeurs des propriétés propres énumérables. Elle ne copie pas le prototype de la source, et une entrée ultérieure de même clé remplace la précédente. { ...state } ne copie pas à lui seul state.profile : écrire dans profile.name via cette copie superficielle modifierait aussi la version précédente. Ne modifiez pas les branches partagées, quelle que soit la référence utilisée.

Pour les tableaux, items.with(index, replacement) renvoie un nouveau tableau sans écrire dans items et préserve l’identité des objets aux autres positions. Les indices négatifs comptent à partir de la fin ; un indice hors limites après normalisation déclenche une RangeError. La copie le long du chemin évite de recopier des branches entières restées inchangées, mais copie les entrées de chaque conteneur recréé. Copier un seul grand tableau peut donc rester coûteux.

Array.prototype.with fait partie d’ECMAScript 2024 ; vérifiez sa prise en charge dans l’environnement d’exécution cible. structuredClone() est une API distincte de la plateforme web : pour un arbre ordinaire de données clonables, elle crée une copie profonde au lieu de partager des branches avec la source. Toutes les valeurs ne sont pas clonables ; une fonction provoque par exemple une DataCloneError.

Exemples

{
  const state = {
    profile: { name: "Ada" },
    settings: { theme: "dark" },
  };

  const next = {
    ...state,
    profile: { ...state.profile, name: "Grace" },
  };

  console.log(`names: ${state.profile.name} -> ${next.profile.name}`);
  console.log(`same root: ${state === next}`);
  console.log(`same profile: ${state.profile === next.profile}`);
  console.log(`same settings: ${state.settings === next.settings}`);
}

Résultat

names: Ada -> Grace
same root: false
same profile: false
same settings: true

`state.profile.name` vaut toujours `Ada`, tandis que `next.profile.name` vaut `Grace`. La racine et `profile` sont de nouveaux objets ; `settings` est le même objet dans les deux versions.

Leçons associées

  • JavaScript · Leçon 18 · Avancé · Version : 4

Sources