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

CKTIS / JavaScript

Element.after() — inserir nós irmãos a seguir a um elemento

Element.after insere nós e texto como nós irmãos, normalmente logo a seguir ao elemento. Não adiciona filhos a esse elemento.

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

Element.after é um método de instância disponibilizado pelo mixin ChildNode na norma DOM, e não pelo ECMAScript. Se o elemento tiver um nó pai, element.after(...nodes) insere normalmente nós e texto logo a seguir ao elemento. Contudo, a preparação dos nós a inserir pode mover o próprio elemento, mesmo que este não seja passado diretamente como argumento. Se a for o único filho de um DocumentFragment chamado f e b for um elemento separado, a.after(b, f) retira a de f e coloca-o a seguir a b, inserindo depois ambos em f pela ordem b, a. Se o próprio elemento for passado como argumento, a sua posição na lista de argumentos é relevante: se a e b forem dois elementos distintos com o mesmo nó pai, a.after(b, a) coloca b imediatamente antes de a.

As cadeias de caracteres são convertidas em nós Text sem serem interpretadas como HTML. Os nós existentes são movidos, não copiados. O método devolve undefined; se o elemento não tiver um nó pai, não insere nada. O nó pai não precisa de estar ligado ao documento.

Uma hierarquia de árvore inválida provoca HierarchyRequestError. Ao contrário de append(), after() não insere filhos no elemento em que o método é chamado. Esta é uma API do ambiente DOM: a versão do Node.js, por si só, não confirma a sua disponibilidade.

Exemplos

const parent = document.createElement('div');
const first = document.createElement('span');
first.textContent = 'A';
const last = document.createElement('span');
last.textContent = 'C';
parent.append(first, last);

const middle = document.createElement('strong');
middle.textContent = 'B';
const result = first.after(' / ', middle);

console.log(parent.textContent);
console.log(first.nextSibling.nodeType === Node.TEXT_NODE);
console.log(middle.nextSibling === last);
console.log(result === undefined);

Resultado

A / BC
true
true
true

O código apresentado e o resultado indicado foram verificados num ambiente isolado com o método documentado para esta versão específica.

Fontes