Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Element.after() — insertar nodos hermanos después de un elemento

Element.after inserta nodos y texto como nodos hermanos, normalmente justo después del elemento. No añade hijos a ese elemento.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

element.after(...nodes)

Element.after es un método de instancia proporcionado por el mixin ChildNode del estándar DOM, no por ECMAScript. Si el elemento tiene un padre, element.after(...nodes) suele insertar nodos y texto justo después de él. Sin embargo, al preparar los nodos para la inserción, el propio elemento puede moverse aunque no se pase directamente como argumento. Si a es el único hijo de un DocumentFragment llamado f y b es un elemento separado, a.after(b, f) saca a de f y lo coloca después de b; luego inserta ambos en f en el orden b, a. Si se pasa el propio elemento como argumento, su posición en la lista de argumentos importa: si a y b son dos elementos distintos con el mismo padre, a.after(b, a) coloca b justo antes de a.

Las cadenas se convierten en nodos Text sin analizarse como HTML. Los nodos existentes se mueven, no se copian. El método devuelve undefined; si el elemento no tiene padre, no inserta nada. El padre no tiene que estar conectado al documento.

Una jerarquía de árbol no válida provoca HierarchyRequestError. A diferencia de append(), after() no inserta hijos en el elemento sobre el que se llama. Esta es una API del entorno DOM: la versión de Node.js por sí sola no confirma su disponibilidad.

Ejemplos

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

El código mostrado y el resultado indicado se verificaron en un entorno aislado mediante el método documentado para esta versión concreta.

Fuentes