Element: getAttribute() method
The getAttribute()
method of the
Element
interface returns the value of a specified attribute on the
element.
If the given attribute does not exist, the value returned will be null
.
If you need to inspect the Attr
node's properties, you can use the getAttributeNode()
method instead.
Syntax
getAttribute(attributeName)
Parameters
attributeName
is the name of the attribute whose value you want to get.
Return value
A string containing the value of attributeName
if the attribute exists, otherwise null
.
Examples
<!-- example div in an HTML DOC -->
<div id="div1">Hi Champ!</div>
// in a console
const div1 = document.getElementById("div1");
//=> <div id="div1">Hi Champ!</div>
const exampleAttr = div1.getAttribute("id");
//=> "div1"
const align = div1.getAttribute("align");
//=> null
Description
Lower casing
When called on an HTML element in a DOM flagged as an HTML document,
getAttribute()
lower-cases its argument before proceeding.
Retrieving nonce values
For security reasons, CSP nonces from non-script
sources, such as CSS selectors, and .getAttribute("nonce")
calls are
hidden.
let nonce = script.getAttribute("nonce");
// returns empty string
Instead of retrieving the nonce from the content attribute, use the
nonce
property:
let nonce = script.nonce;
Specifications
Specification |
---|
DOM Standard # ref-for-dom-element-getattribute① |
Browser compatibility
BCD tables only load in the browser