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

CKTIS / JavaScript

Element.remove() : détacher un élément

La méthode element.remove() détache un élément de son parent. Elle ne prend aucun argument, renvoie undefined et ne fait rien si l’élément n’a pas de parent.

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.remove()

Element.remove désigne la méthode d’instance element.remove(), fournie par le mixin ChildNode. Il s’agit d’une API DOM, et non d’une fonction définie par ECMAScript.

La méthode détache l’élément et son sous-arbre de son parent. Une référence conservée pointe toujours vers le même objet ; celui-ci peut être inséré à nouveau. En l’absence de parent, l’appel ne fait rien.

Contrairement à parent.removeChild(element), cette méthode n’a pas besoin d’une référence au parent et renvoie undefined, et non le nœud supprimé. L’exemple utilise un arbre détaché : l’élément n’a pas besoin d’appartenir au document.

Exemples

const parent = document.createElement('div');
const element = document.createElement('span');
parent.appendChild(element);

console.log(parent.childNodes.length);
const result = element.remove();
console.log(parent.childNodes.length);
console.log(element.parentNode === null);
console.log(result === undefined);
element.remove();
console.log(parent.childNodes.length);

Résultat

1
0
true
true
0

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