Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Element.before() — insérer avant un élément

Element.before() insère des nœuds et du texte dans le parent de l’élément, et non dans l’élément lui-même. Ils sont normalement insérés avant l’élément de référence.

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

Syntaxe

element.before(...nodes)

Element.before est une méthode DOM issue du mixin ChildNode, et non une fonction ECMAScript. element.before(...nodes) accepte des nœuds et des chaînes de caractères ; les chaînes deviennent des nœuds Text, pas du HTML.

Les nœuds existants sont déplacés, et non copiés. Si l’élément de référence est lui-même passé en argument, il peut aussi être déplacé. Si le parent de target est un Element ou un DocumentFragment, target.before(target, 'x') place le texte après target, et non avant. Si target est l’élément racine du document, le même appel lève une exception HierarchyRequestError : un fragment ayant un nœud Text pour enfant ne peut pas être inséré dans un Document. En cas de succès, la méthode renvoie undefined.

Un élément sans parent reste inchangé ; le parent n’a pas besoin d’appartenir au document. Une hiérarchie invalide provoque HierarchyRequestError. Contrairement à parent.insertBefore(node, element), cette méthode s’appelle sur l’élément de référence.

Exemples

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

Résultat

A + B
true
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources