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

CKTIS / JavaScript

Node.insertBefore — insérer avant un enfant

Node.insertBefore insère ou déplace un nœud avant un enfant indiqué. Passer null permet de l’insérer à la fin.

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

parent.insertBefore(node, child)

Appelez Node.insertBefore sur le parent : parent.insertBefore(node, child). child doit être un enfant direct de ce parent ou valoir null (pour ajouter le nœud à la fin). Fournissez les deux arguments. La méthode renvoie node.

Un nœud déjà présent est déplacé, et non copié. Avec un DocumentFragment, ses enfants sont insérés ; le fragment renvoyé est vide.

Une hiérarchie interdite, par exemple un cycle, provoque HierarchyRequestError. La méthode vérifie si l’insertion créerait un cycle avant de vérifier si child appartient au parent. Si l’insertion créerait un cycle, la méthode lève HierarchyRequestError, même si child n’appartient pas au parent. Si les vérifications précédentes réussissent et que child n’est ni null ni un enfant direct du parent, elle lève NotFoundError. Il s’agit d’une API DOM, et non d’ECMAScript ; la seule présence de Node.js 24 ne garantit pas que le DOM soit disponible.

Exemples

const parent = document.createElement('div');
const a = document.createTextNode('A');
const b = document.createTextNode('B');
parent.insertBefore(b, null);
const returned = parent.insertBefore(a, b);
console.log(parent.textContent);
console.log(returned === a);
parent.insertBefore(b, a);
console.log(parent.textContent);

Résultat

AB
true
BA

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