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

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.

Sources