Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Element.getAttribute — odczyt wartości atrybutu

Element.getAttribute odczytuje atrybut elementu DOM jako ciąg znaków lub zwraca null, gdy atrybut nie istnieje.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

element.getAttribute(qualifiedName)

element.getAttribute(qualifiedName) zwraca wartość pierwszego atrybutu o podanej nazwie kwalifikowanej. Wynikiem jest ciąg znaków albo null, jeśli atrybut nie istnieje. Pusta wartość to "", nie null; tekst "12" nie jest liczbą. Metoda nie zmienia elementu.

Dla elementów w przestrzeni nazw HTML, należących do dokumentu HTML, nazwa jest przed wyszukiwaniem zamieniana na małe litery ASCII. Poza tym przypadkiem wielkość liter ma znaczenie. Do wyszukiwania według przestrzeni nazw i nazwy lokalnej służy getAttributeNS(namespace, localName).

Przykłady

const element = document.createElement('div');
element.setAttribute('data-count', '12');
element.setAttribute('data-empty', '');

console.log(JSON.stringify([
  element.getAttribute('data-count'),
  element.getAttribute('data-empty'),
  element.getAttribute('data-missing')
]));

Wynik

["12","",null]

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła