CKTIS / JavaScript
Element.append — acrescentar nós e texto
`Element.append` acrescenta nós e texto no final de um elemento e devolve `undefined`. Se `a` e `b` forem elementos distintos, após uma chamada bem-sucedida a `element.append(a, b, a)`, ficam no fim `b` e, a seguir, `a`: a última ocorrência de `a` move o nó em vez de o copiar. Se, pelo contrário, `a` for um `DocumentFragment` com um único nó de texto e `b` for um elemento separado, a primeira ocorrência de `a` coloca o nó de texto antes de `b` e esvazia o fragmento. A última ocorrência não acrescenta nada, e o fragmento em si não é inserido.
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
element.append(...nodes)Element.append provém do mixin ParentNode da norma DOM, não de ECMAScript. Acrescenta zero ou mais argumentos depois do último filho do elemento.
As cadeias de caracteres tornam-se nós Text, não marcação HTML. Um nó existente é movido, não copiado. Um DocumentFragment acrescenta os seus filhos e fica vazio.
Ao contrário de appendChild, append aceita vários argumentos, incluindo texto, e devolve undefined. Uma hierarquia inválida, como inserir um elemento dentro de si próprio, provoca HierarchyRequestError.
Exemplos
const box = document.createElement('div');
const label = document.createElement('span');
label.textContent = 'OK';
const result = box.append('Status: ', label, '!');
console.log(box.textContent);
console.log(box.childNodes.length);
console.log(result);Resultado
Status: OK! 3 undefined
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.