element.getAttribute

getAttribute renvoie la valeur d'un attribut donné de l'élément spécifié. Si l'attribut n'existe pas, la valeur renvoyée sera soit null soit "" (une chaine vide) ; voir Notes pour plus de détails.

Syntaxe

let attribut = element.getAttribute(nom_attribut)

  • attribut est une chaine contenant la valeur de l'attribut nom_attribut.
  • nom_attribut est le nom de l'attribut dont on désire connaitre la valeur.

Exemple

const div1 = document.getElementById("div1");
const align = div1.getAttribute("align");

alert(align); // affiche la valeur de l'attribut align pour l'élément dont l'id="div1"

Description

Sensibilité à la casse

Le paramètre nom_attribut est généralement sensible à la casse, mais ne l'est pas lorsqu'il est utilisé sur des éléments HTML.

Attributs inexistants

À peu près tous les navigateurs (Firefox, Internet Explorer, Opera, Safari, Konqueror et iCab, sans que cette liste soit exhaustive) renvoient null lorsque l'attribut demandé n'existe pas sur l'élément spécifié. La spécification DOM indique cependant que la valeur de retour correcte dans ce cas est en fait la chaine vide "", et certaines implémentation DOM auront ce comportement. Par conséquent, vous devriez utiliser element.hasAttribute() pour vérifier l'existence d'un attribut avant d'appeler getAttribute() s'il est possible que l'attribut n'existe pas sur l'élément spécifié.

Récupération de valeurs

Pour des raisons de sécurité, les nonces CSP des sources autres que des scripts, telles que les feuilles de style CSS, et les appels à getAttribute("nonce") sont interdits.

let nonce = script.getAttribute("nonce");
// renvoie une chaine vide

Plutôt que de tenter de lire le nonce via l’attribut, utilisez la propriété nonce :

let nonce = script.nonce;

Compatibilité des navigateurs

Nous convertissons les données de compatibilité dans un format JSON. Ce tableau de compatibilité utilise encore l'ancien format car nous n'avons pas encore converti les données qu'il contient. Vous pouvez nous aider en contribuant !
Fonctionnalité Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Basic support 29 (Oui) 23 (Oui) (Oui) 6

Méthodes DOM traitant des attributs sur les éléments :

DOM Level 1 (le plus courant) DOM Level 2 DOM Level 1 traitant directement les nœuds Attr DOM Level 2 traitant directement les nœuds Attr
setAttribute (DOM 1) setAttributeNS setAttributeNode setAttributeNodeNS
getAttribute (DOM 1) getAttributeNS getAttributeNode getAttributeNodeNS
hasAttribute (DOM 2) hasAttributeNS - -
removeAttribute (DOM 1) removeAttributeNS removeAttributeNode -

Spécification