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

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.

Sources