CKTIS / JavaScript
Element.prepend — insérer au début d’un élément
Element.prepend insère des nœuds et du texte avant le premier enfant d’un élément. Si a et b sont deux éléments distincts, prepend(a, b, a) insère b puis a, sans dupliquer a.
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.prepend(...nodes)Element.prepend est une méthode DOM issue du mixin ParentNode, et non une fonction ECMAScript. Elle accepte des nœuds et des chaînes de caractères ; elle renvoie undefined.
Les arguments sont insérés avant le premier enfant, même s’il s’agit d’un nœud texte. Les chaînes deviennent des nœuds Text, et non du balisage HTML. Les nœuds existants sont déplacés, pas copiés.
Le non-respect des contraintes de hiérarchie de l’arbre déclenche HierarchyRequestError. L’exemple nécessite un environnement DOM ; la seule version de Node.js ne permet pas d’établir la disponibilité de cette méthode.
Exemples
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);Résultat
Start | End 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.