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

CKTIS / JavaScript

Element.before() — insertar antes de un elemento

Element.before() inserta nodos y texto en el nodo padre del elemento, no en el elemento mismo. Normalmente quedan antes del elemento de referencia.

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

Element.before es un método del DOM definido en el mixin ChildNode, no una función de ECMAScript. element.before(...nodes) acepta nodos y cadenas; las cadenas se convierten en nodos Text, no en HTML.

Los nodos existentes se mueven, no se copian. Si pasas el propio elemento de referencia como argumento, este también puede moverse. Si el nodo padre de target es un Element o un DocumentFragment, target.before(target, 'x') coloca el texto después de target, no antes. Si target es el elemento raíz del documento, la misma llamada lanza una excepción HierarchyRequestError: no se puede insertar en un Document un fragmento con un nodo Text como hijo. Si la llamada se completa correctamente, el método devuelve undefined.

Un elemento sin padre permanece sin cambios; no es necesario que el padre pertenezca al documento. Una jerarquía no válida provoca HierarchyRequestError. A diferencia de parent.insertBefore(node, element), este método se invoca sobre el elemento de referencia.

Ejemplos

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

El código mostrado y el resultado indicado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión concreta.

Fuentes