Element: метод getAttribute()

Метод getAttribute() интерфейса Element возвращает значение указанного атрибута.

Если атрибут не существует, то вернётся значение null или "" (пустая строка), подробности смотрите в разделе «Несуществующие атрибуты».

Если необходимо получить свойства узла, то можно использовать метод getAttributeNode() (en-US).

Синтаксис

js
getAttribute(attributeName)

Параметры

attributeName

имя атрибута, значение которого необходимо получить.

Возвращаемое значение

Строка, содержащая значение attributeName.

Примеры

html
<div id="div1">Привет!</div>
js
const div1 = document.getElementById("div1");
// <div id="div1">Привет!</div>

const exampleAttr = div1.getAttribute("id");
// "div1"

const align = div1.getAttribute("align");
// null

Описание

Приведение к нижнему регистру

При вызове у HTML-элемента в HTML-документе getAttribute() приводит аргумент к нижнему регистру.

Несуществующие атрибуты

Все современные браузеры возвращают null, если у элемента нет указанного атрибута.

Получение значений криптографических одноразовых номеров

По соображениям безопасности получение криптографических одноразовых номеров («nonce») из источников, отличных от скриптов (таких как CSS селекторы и вызовы .getAttribute("nonce")), недоступно.

js
let nonce = script.getAttribute("nonce");
// вернёт пустую строку

Вместо этого следует использовать свойство nonce:

js
let nonce = script.nonce;

Спецификации

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

Совместимость с браузерами

BCD tables only load in the browser

Смотрите также