NavigatorID.userAgent

A propriedade read-only (apenas leitura) NavigatorID.userAgent retorna a string do agente do usu√°rio (user agent) para o browser atual.

 A especif√≠ca√ß√£o demanda que os navegadores forne√ßam, nessa propriedade, a menor quantidade de informa√ß√Ķes posss√≠vel. Nunca assuma que o valor dessa propriedade permanecer√° o mesmo em ver√ß√Ķes futuras de um mesmo navegador. Tente n√£o utiliza-la, ou ultileze-a somente para ver√ß√Ķes presentes ou passadas de um navegador. Novos navegadores podem utilizar-se do mesmo agente do usu√°rio, ou parte dele, que navegadores mais aintigos: n√£o existe qualquer garantia de que o agente do navegador √© de fato o enunciado por essa propriedade.

Além disso, tenha em mente que os usuários do navegador podem manipular o valor dessa propriedade caso queiram (UA spoofing).

A idenficação de browsers baseada na detecção de sua string de agente de usuário não é confiável e não é recomendável, pois a string de agente de usuário pode ser configurada pelo usuário. Por exemplo:

  • No Firefox, voc√™ pode alterar a prefer√™ncia general.useragent.override em about:config. Algumas exten√ß√Ķes do Firefox fazem isso. No entanto, isso altera somente o header HTTP que √© enviado ao servidor, n√£o afetando a detec√ß√£o de browser efetuada por c√≥digo JavaScript.
  • O Opera 6+ permite aos usu√°rios configurar a string de identifica√ß√£o do browser atrav√©s de um menu.
  • O Microsoft Internet Explorer faz uso de registros do Windows.
  • O Safari e o iCab permitem aos usu√°rios alterar, atrav√©s de um menu, a string de agente do usu√°rio para os valores predefinidos do Internet Explorer ou Netscape.

Sintaxe

var au = window.navigator.userAgent;

Valor

au guarda o valor da string de agente de usu√°rio do browser atual.

A string de agente de usu√°rio √© contruida em uma estrutura formal que pode ser decomposta em diferentes informa√ß√Ķes. Cada uma dessas informa√ß√Ķes √© provinda de outras propriedades de window.navigator, que tamb√©m podem ser configuradas pelo usu√°rio. Navegadores baseados na engine Gecko seguem a seguinte estrutura:

ageteDeUsu√°rio = c√≥digoDoNomeDoAplicativo/vers√£oDoAplicativo n√ļmero (Plataforma; Seguran√ßa; OS-ou-CPU;
Localiza√ß√£o; rv: n√ļmero-da-ver√ß√£o-de-revis√£o) produto/produtoSub
Nome-do-Aplicativo vers√£o-do-Nome-do-Aplicativo

Examplo

alert(window.navigator.userAgent)
// alerta "Mozilla/5.0 (Windows; U; Win98; en-US; rv:0.9.2) Gecko/20010725 Netscape6/6.1"

Especifica√ß√Ķes

Especificação Status Comentário
HTML Living Standard
The definition of 'NavigatorID.userAgent' in that specification.
Padrão em tempo real Definição inicial.

Compatibilidade

BCD tables only load in the browser

Veja também