Element.getAttribute()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Resumo

getAttribute() retorna o valor de um argumento específico do elemento. Se o atributo não existir, o valor retornado será null ou "" (string vazia). Veja Notas para mais detalhes.

Sintaxe

var atributo = element.getAttribute(nomeDoAtributo);

onde

  • atributo é uma string contendo o valor do nomeDoAtributo.
  • nomeDoAtributo é o nome do atributo cujo deseja se obter o valor.

Exemplo

js
var div1 = document.getElementById("div1");
var align = div1.getAttribute("align");

alert(align); // mostra o valor do atributo "align" do elemento com id="div1"

Notas

Quando for utilizado para um elemento HTML num DOM sinalizado como documento HTML, getAttribute() troca de caixa alta para caixa baixa (maiúscula para minúscula) seu argumento antes de prosseguir.

Essencialmente todos navegadores (Firefox, Internet Explorer, versões recentes do Opera, Safari, Konqueror, e iCab, por exemplo) retornam null quando o atributo especificado não existe no elemento em questão, seguindo que o esboço atual de especificações DOM diz. A velha especificação do DOM 3 Core, por sua vez, diz que correto é retornar uma string vazia e algumas implementações de DOM se comportam dessa forma. Por exemplo, a implementação do getAttribute no XUL (Gecko) segue as especificações do DOM 3 Core e retorna uma string vazia. Consequentemente, deve-se usar Element.hasAttribute() para checar a existência do atributo antes de utilizar o getAttribute()caso exista a possibilidade do argumento inexistir.

Compatibilidade com navegadores

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
getAttribute

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Especificação