CKTIS / JavaScript
Node.cloneNode() : copier un nœud DOM
Node.cloneNode() crée un nœud DOM distinct. L’argument subtree détermine si les descendants sont également copiés.
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 copy = node.cloneNode();
const deepCopy = node.cloneNode(true);node.cloneNode() renvoie un nouveau nœud sans parent. Par défaut, subtree = false omet les descendants ; true les copie récursivement, y compris les nœuds texte. Les attributs de l’élément sont copiés dans les deux cas.
La copie n’est pas l’original et n’hérite pas des écouteurs enregistrés avec addEventListener(). Avant de l’insérer dans le même document, modifiez l’id de la copie pour éviter les doublons.
Un appel direct sur un ShadowRoot déclenche NotSupportedError. Il s’agit d’une API DOM de navigateur, et non d’une fonctionnalité ECMAScript ; la version de Node.js ne permet pas d’établir sa disponibilité.
Exemples
const original = document.createElement('button');
original.id = 'original';
original.textContent = 'Hello';
let calls = 0;
original.addEventListener('click', () => calls++);
const shallow = original.cloneNode();
const deep = original.cloneNode(true);
deep.id = 'copy';
deep.click();
console.log(shallow.childNodes.length);
console.log(deep.textContent);
console.log(deep.parentNode === null);
console.log(deep === original);
console.log(calls);Résultat
0 Hello true false 0
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.