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

js
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

html
<!-- example div in an HTML DOC -->
<div id="div1">Hi Champ!</div>
js
// 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.

js
let nonce = script.getAttribute("nonce");
// returns empty string

Instead of retrieving the nonce from the content attribute, use the nonce property:

js
let nonce = script.nonce;

Specifications

Specification
DOM Standard
# ref-for-dom-element-getattribute①

Browser compatibility

BCD tables only load in the browser

See also