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

CKTIS / JavaScript

Element.before() — inserir antes de um elemento

Element.before() insere nós e texto no nó pai do elemento, não no próprio elemento. Normalmente, ficam antes do elemento de referência.

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.before(...nodes)

Element.before é um método do DOM do mixin ChildNode, não uma função ECMAScript. element.before(...nodes) aceita nós e cadeias de caracteres; as cadeias tornam-se nós Text, não HTML.

Os nós existentes são movidos, não copiados. Se passares o próprio elemento de referência como argumento, este também pode ser movido. Se o nó pai de target for um Element ou um DocumentFragment, target.before(target, 'x') coloca o texto depois de target, e não antes. Se target for o elemento raiz do documento, a mesma chamada lança uma exceção HierarchyRequestError: não é possível inserir num Document um fragmento que tenha um nó Text como filho. Se a chamada for bem-sucedida, o método devolve undefined.

Um elemento sem nó pai permanece inalterado; o nó pai não tem de pertencer ao documento. Uma hierarquia inválida causa HierarchyRequestError. Ao contrário de parent.insertBefore(node, element), este método é chamado no elemento de referência.

Exemplos

const parent = document.createElement('div');
const target = document.createElement('span');
target.textContent = 'B';
parent.appendChild(target);

const first = document.createElement('strong');
first.textContent = 'A';
const result = target.before(first, ' + ');

console.log(parent.textContent);
console.log(parent.firstChild === first);
console.log(result === undefined);

Resultado

A + B
true
true

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

Fontes