CKTIS / JavaScript
Element.removeAttribute — supprimer un attribut
Element.removeAttribute supprime un attribut d’un élément à partir de son nom. La méthode renvoie undefined ; l’absence de l’attribut ne provoque pas d’erreur.
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.removeAttribute(qualifiedName)Element.removeAttribute supprime le premier attribut de l’élément dont le nom qualifié correspond au nom recherché. C’est une méthode du DOM, et non une fonction d’ECMAScript lui-même.
Si l’élément appartient à l’espace de noms HTML et que le document auquel il appartient est un document HTML, la méthode convertit les lettres majuscules ASCII (A–Z) de qualifiedName en minuscules avant de rechercher l’attribut. Par exemple, removeAttribute('DATA-STATE') peut supprimer l’attribut data-state. Dans les autres cas, la méthode utilise l’argument sans modifier sa casse.
L’appel element.removeAttribute(qualifiedName) renvoie undefined, et non la valeur supprimée. Si aucun attribut ne correspond, rien ne change. Des attributs appartenant à des espaces de noms différents peuvent avoir le même nom qualifié. Un appel ne supprime que le premier attribut correspondant. S’il reste un attribut correspondant, hasAttribute(qualifiedName) renvoie true et getAttribute(qualifiedName) renvoie la valeur du premier attribut correspondant restant. S’il n’en reste aucun, ces méthodes renvoient respectivement false et null.
Supprimer un attribut n’est pas la même chose que définir une chaîne vide avec setAttribute : un attribut vide existe toujours. La méthode ne supprime pas l’élément lui-même. Pour désigner un attribut à l’aide de son espace de noms et de son nom local, utilise removeAttributeNS(namespace, localName).
Exemples
const element = document.createElement('div');
element.setAttribute('data-state', 'ready');
console.log(element.getAttribute('data-state'));
const result = element.removeAttribute('data-state');
console.log(element.hasAttribute('data-state'));
console.log(element.getAttribute('data-state'));
console.log(result);
element.removeAttribute('data-state');
console.log(element.hasAttribute('data-state'));Résultat
ready false null undefined false
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.