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.