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.