Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Node.cloneNode(): copiar um nó DOM

Node.cloneNode() cria um nó DOM separado. O argumento subtree determina se os descendentes também são copiados.

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

Sintaxe

const copy = node.cloneNode();
const deepCopy = node.cloneNode(true);

node.cloneNode() devolve um novo nó sem nó ascendente. O valor predefinido subtree = false omite os descendentes; true copia-os recursivamente, incluindo os nós de texto. Os atributos do elemento são copiados em ambos os casos.

A cópia não é o original e não herda os listeners registados com addEventListener(). Antes de a inserir no mesmo documento, altera o id copiado para evitar duplicados.

Uma chamada direta num ShadowRoot lança NotSupportedError. Esta é uma API DOM do navegador, não uma funcionalidade ECMAScript; a versão do Node.js não comprova a sua disponibilidade.

Exemplos

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);

Resultado

0
Hello
true
false
0

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes