Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Element.before() — inserire prima di un elemento

Element.before() inserisce nodi e testo nel nodo genitore, non nell’elemento stesso. Di norma, li inserisce prima dell’elemento di riferimento.

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

Sintassi

element.before(...nodes)

Element.before è un metodo DOM del mixin ChildNode, non una funzione ECMAScript. element.before(...nodes) accetta nodi e stringhe; le stringhe diventano nodi Text, non HTML.

I nodi esistenti vengono spostati, non copiati. Se passi come argomento l’elemento di riferimento stesso, anche questo può essere spostato. Se il genitore di target è un Element o un DocumentFragment, target.before(target, 'x') colloca il testo dopo target, non prima. Se target è l’elemento radice del documento, la stessa chiamata genera un’eccezione HierarchyRequestError: un frammento con un nodo Text come figlio non può essere inserito in un Document. Se la chiamata va a buon fine, il metodo restituisce undefined.

Un elemento senza genitore rimane invariato; il genitore non deve necessariamente appartenere al documento. Una gerarchia non valida causa HierarchyRequestError. A differenza di parent.insertBefore(node, element), questo metodo si chiama sull’elemento di riferimento.

Esempi

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);

Risultato

A + B
true
true

Il codice mostrato e il risultato indicato sono stati verificati in un ambiente isolato con il metodo documentato nella prova di verifica di questa specifica versione.

Fonti