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

Soit l'HTML :

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

Exemple de JavaScript :

const div1 = document.getElementById("div1");
//=> <div id="div1">Hi Champ!</div>

const attributID = div1.getAttribute("id");
//=> "div1"

cont alignement = div1.getAttribute("align");
//=> null

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 nonces

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;

Spécifications

Spécification État
DOM
La définition de 'getAttribute()' dans cette spécification.
Standard évolutif

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
getAttributeChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 5Opera Support complet 8Safari Support complet 1.3WebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet 10.1Safari iOS Support complet 1Samsung Internet Android Support complet 1.0

Légende

Support complet  
Support complet