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

CKTIS / JavaScript

Element.prepend — insertar al principio de un elemento

Element.prepend inserta nodos y texto antes del primer hijo de un elemento. Si a y b son elementos distintos, prepend(a, b, a) inserta primero b y luego a, sin duplicar a.

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

Element.prepend es un método del DOM procedente del mixin ParentNode, no una función de ECMAScript. Acepta nodos y cadenas; devuelve undefined.

Los argumentos se insertan antes del primer hijo, incluso si este es un nodo de texto. Las cadenas se convierten en nodos Text, no en marcado HTML. Los nodos existentes se mueven, no se copian.

Si se incumplen las restricciones de jerarquía del árbol, se lanza HierarchyRequestError. El ejemplo requiere un entorno con DOM; la versión de Node.js por sí sola no demuestra que este método esté disponible.

Ejemplos

const container = document.createElement('div');
const label = document.createElement('span');
label.textContent = 'Start';
container.textContent = 'End';
const result = container.prepend(label, ' | ');

console.log(container.textContent);
console.log(container.firstChild === label);
console.log(result === undefined);

Resultado

Start | End
true
true

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

Fuentes