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

CKTIS / JavaScript

Element.getAttribute — lire la valeur d’un attribut

Element.getAttribute lit l’attribut d’un élément DOM sous forme de chaîne, ou renvoie null si cet attribut n’existe pas.

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.getAttribute(qualifiedName)

element.getAttribute(qualifiedName) renvoie la valeur du premier attribut portant le nom qualifié indiqué. Le résultat est une chaîne, ou null si l’attribut n’existe pas. Une valeur vide est "", et non null ; le texte "12" n’est pas un nombre. Cette méthode ne modifie pas l’élément.

Pour les éléments de l’espace de noms HTML appartenant à un document HTML, le nom est converti en minuscules ASCII avant la recherche. En dehors de ce cas, la casse est importante. Utilisez getAttributeNS(namespace, localName) pour rechercher un attribut par espace de noms et nom local.

Exemples

const element = document.createElement('div');
element.setAttribute('data-count', '12');
element.setAttribute('data-empty', '');

console.log(JSON.stringify([
  element.getAttribute('data-count'),
  element.getAttribute('data-empty'),
  element.getAttribute('data-missing')
]));

Résultat

["12","",null]

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