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.