CKTIS / JavaScript
Element.prepend — inserir no início de um elemento
Element.prepend insere nós e texto antes do primeiro filho de um elemento. Se a e b forem elementos distintos, prepend(a, b, a) insere primeiro b e depois a, sem duplicar a.
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.prepend(...nodes)Element.prepend é um método DOM do mixin ParentNode, não uma função ECMAScript. Aceita nós e cadeias de caracteres; devolve undefined.
Os argumentos são inseridos antes do primeiro filho, mesmo que este seja um nó de texto. As cadeias de caracteres tornam-se nós Text, não marcação HTML. Os nós existentes são movidos, não copiados.
A violação das restrições de hierarquia da árvore gera HierarchyRequestError. O exemplo requer um ambiente DOM; a versão do Node.js, por si só, não comprova a disponibilidade deste método.
Exemplos
const container = document.createElement('div');
const label = document.createElement('span');
label.textContent = 'Start';
container.textContent = 'End';
const result = container.prepend(label, ' | ');
console.log(container.textContent);
console.log(container.firstChild === label);
console.log(result === undefined);Resultado
Start | End true 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.