structuredClone pour les copies profondes
Clonez des objets complexes en toute sécurité.
structuredClone pour les copies profondes est une leçon JavaScript Academy gratuite sur CoddyKit. Ceci est la leçon 4 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage JavaScript Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours JavaScript Academy comprend 4 leçons au total.
Le problème de la copie profonde
La décomposition et Object.assign créent des copies superficielles : les objets imbriqués sont partagés par référence. Pour dupliquer entièrement une structure imbriquée, vous avez besoin d'une copie profonde.
structuredClone est la solution intégrée.
Pourquoi la décomposition ne suffit pas
Une copie créée par décomposition partage les objets imbriqués. Modifier la partie imbriquée de la copie modifie également l'original.
const original = { user: { name: 'Ada' } };
const shallow = { ...original };
shallow.user.name = 'Grace';
console.log(original.user.name);structuredClone à la rescousse
structuredClone copie récursivement toute la structure. Les modifications apportées au clone ne touchent jamais l'original.
const original = { user: { name: 'Ada' } };
const deep = structuredClone(original);
deep.user.name = 'Grace';
console.log(original.user.name);
console.log(deep.user.name);Des objets imbriqués indépendants
Après le clonage, chaque objet imbriqué est une référence distincte : la comparaison d'identité est donc fausse à tous les niveaux.
const original = { a: { b: { c: 1 } } };
const clone = structuredClone(original);
console.log(original === clone);
console.log(original.a === clone.a);
console.log(original.a.b === clone.a.b);Clonage des tableaux
Les tableaux, y compris ceux qui sont imbriqués, sont eux aussi clonés en profondeur. Ajouter un élément à un tableau imbriqué du clone ne modifie pas la source.
const original = { tags: ['a', 'b'], meta: { nested: [1] } };
const clone = structuredClone(original);
clone.meta.nested.push(2);
console.log(original.meta.nested);
console.log(clone.meta.nested);Prise en charge des Map et Set
Contrairement à JSON.parse(JSON.stringify(...)), structuredClone prend en charge de nombreux types intégrés, notamment Map, Set et Date.
const original = { items: new Set([1, 2, 3]), when: new Date(0) };
const clone = structuredClone(original);
clone.items.add(4);
console.log([...original.items]);
console.log([...clone.items]);
console.log(clone.when instanceof Date);Prise en charge des références circulaires
Un objet qui se référence lui-même fait échouer l'astuce JSON, mais se clone correctement avec structuredClone.
const node = { name: 'root' };
node.self = node;
const clone = structuredClone(node);
console.log(clone.name);
console.log(clone.self === clone);Ce qu'il ne peut pas cloner
structuredClone ne peut pas copier les fonctions ni les nœuds DOM ; il lève une DataCloneError. Il supprime également les chaînes de prototypes et renvoie des objets simples.
try {
structuredClone({ fn: () => 1 });
} catch (e) {
console.log(e.name);
}Les prototypes ne sont pas conservés
Une instance de classe clonée devient un objet simple : les données sont copiées, mais les méthodes et le prototype sont perdus.
class Point {
constructor(x) { this.x = x; }
show() { return this.x; }
}
const p = new Point(5);
const clone = structuredClone(p);
console.log(clone.x);
console.log(clone instanceof Point);structuredClone contre l'astuce JSON
L'ancienne approche JSON.parse(JSON.stringify(x)) perd undefined, transforme les dates en chaînes et échoue en présence de cycles. structuredClone évite ces problèmes pour les données sérialisables.
const data = { when: new Date(0), missing: undefined, n: 5 };
const viaJson = JSON.parse(JSON.stringify(data));
const viaClone = structuredClone(data);
console.log(typeof viaJson.when);
console.log(viaClone.when instanceof Date);Pourquoi c'est important
structuredClone fournit une copie profonde fiable et intégrée pour les données simples, en remplacement des clones fragiles écrits manuellement. Utilisez-le lorsque vous avez besoin d'une copie entièrement indépendante d'un état imbriqué, en gardant à l'esprit qu'il supprime les fonctions et les prototypes.
const state = { list: [{ id: 1 }], settings: { theme: 'dark' } };
const snapshot = structuredClone(state);
snapshot.list[0].id = 99;
console.log(state.list[0].id);
console.log(snapshot.list[0].id);Vérification rapide
Pourquoi utiliser structuredClone plutôt que l'opérateur de décomposition pour des données imbriquées ?
Récapitulatif : structuredClone
Vous avez appris à effectuer des copies profondes fiables :
- La décomposition est superficielle ;
structuredClonecopie en profondeur. - Il prend en charge
Map,Set,Dateet les références circulaires. - Il ne peut pas cloner les fonctions ni les nœuds DOM et supprime les prototypes.
- Il constitue un remplacement plus sûr de l'astuce
JSON.parse(JSON.stringify()).
Questions Fréquemment Posées
La leçon « structuredClone pour les copies profondes » est-elle gratuite ?
Oui — le texte complet de « structuredClone pour les copies profondes » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours JavaScript Academy, passe à CoddyKit PRO. Le cours JavaScript Academy comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « structuredClone pour les copies profondes » ?
Clonez des objets complexes en toute sécurité. Tu pratiques JavaScript Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer JavaScript Academy ?
Aucune expérience préalable n'est requise. JavaScript Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 4 sur 4.
Combien de temps prend la leçon « structuredClone pour les copies profondes » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon JavaScript Academy ?
Oui. Chaque leçon JavaScript Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Object.freeze et seal
- Gel superficiel ou profond
- Schémas de mise à jour immuable
- structuredClone pour les copies profondes