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

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.

Fontes