CKTIS / JavaScript
DocumentFragment — agrupar nós DOM
DocumentFragment agrupa nós DOM sem um elemento de contorno. Ao inserir o fragmento, os seus filhos são movidos e este fica vazio.
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 fragment = new DocumentFragment();
// Alternative:
const otherFragment = document.createDocumentFragment();
fragment.append(node);
parent.appendChild(fragment);DocumentFragment é um nó DOM, não um elemento. Crie-o com new DocumentFragment() ou document.createDocumentFragment() para preparar filhos fora da árvore do documento.
parent.appendChild(fragment) move os filhos pela ordem, sem os clonar nem acrescentar um elemento de contorno. O fragmento fica vazio e pode ser reutilizado. O exemplo também verifica a identidade de um nó.
Trata-se de uma API Web, não de uma funcionalidade ECMAScript. O exemplo requer um documento de navegador; o Node 24 não comprova que seja suportado. Não presuma que garante um aumento de velocidade.
Exemplos
(() => {
const fragment = new DocumentFragment();
const list = document.createElement('ul');
const first = document.createElement('li');
first.textContent = 'A';
fragment.append(first);
const second = document.createElement('li');
second.textContent = 'B';
fragment.append(second);
list.appendChild(fragment);
console.log(list.textContent);
console.log(list.children.length);
console.log(fragment.childNodes.length);
console.log(list.firstChild === first);
})();Resultado
AB 2 0 true
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.