Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Element.getAttribute — ler o valor de um atributo

Element.getAttribute lê o atributo de um elemento DOM como uma cadeia de caracteres ou devolve null se esse atributo não existir.

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

Sintaxe

element.getAttribute(qualifiedName)

element.getAttribute(qualifiedName) devolve o valor do primeiro atributo com o nome qualificado indicado. O resultado é uma cadeia de caracteres ou null se o atributo não existir. Um valor vazio é "", não null; o texto "12" não é um número. O método não modifica o elemento.

Nos elementos do espaço de nomes HTML que pertencem a um documento HTML, o nome é convertido para minúsculas ASCII antes da pesquisa. Fora desse caso, as maiúsculas e minúsculas são relevantes. Utilize getAttributeNS(namespace, localName) para pesquisar um atributo pelo espaço de nomes e pelo nome local.

Exemplos

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')
]));

Resultado

["12","",null]

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes