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

CKTIS / JavaScript

Node.insertBefore — inserir antes de um nó filho

Node.insertBefore insere ou move um nó para antes de um filho indicado. Se passar null, o nó é inserido no fim.

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

parent.insertBefore(node, child)

Chame Node.insertBefore no elemento pai: parent.insertBefore(node, child). child tem de ser um filho direto do elemento pai ou null (para acrescentar o nó no fim). Forneça os dois argumentos. O método devolve node.

Um nó que já existe é movido, não copiado. Com um DocumentFragment, são inseridos os seus filhos; o fragmento devolvido fica vazio.

Uma hierarquia não permitida, como um ciclo, provoca HierarchyRequestError. O método verifica se a inserção criaria um ciclo antes de verificar se child pertence ao nó pai. Se a inserção criar um ciclo, o método lança HierarchyRequestError, mesmo que child não pertença ao nó pai. Se as verificações anteriores forem bem-sucedidas e child não for null nem um filho direto do nó pai, o método lança NotFoundError. Esta é uma API do DOM, não do ECMAScript; a presença de Node.js 24, por si só, não comprova que o DOM esteja disponível.

Exemplos

const parent = document.createElement('div');
const a = document.createTextNode('A');
const b = document.createTextNode('B');
parent.insertBefore(b, null);
const returned = parent.insertBefore(a, b);
console.log(parent.textContent);
console.log(returned === a);
parent.insertBefore(b, a);
console.log(parent.textContent);

Resultado

AB
true
BA

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