Esta tradução está incompleta. Por favor, ajude a traduzir este artigo.

A propriedade NavigatorLanguage.language retorna uma string representando a língua de preferência do usuário, normalmente a língua da interface do navegador.

Sintaxe

var lang = navigator.language 

Valor

Uma DOMString lang armazena a string representando a língua como definida em BCP 47. Exemplos de códigos de línguas válidos incluem "en", "en-US", "fr", "fr-FR", "es-ES", etc.

Atente-se que no Safari no macOS e iOS antes da versão 10.2, o código do país é retornado em caixa baixa: "en-us", "fr-fr" etc.

Exemplo

if (window.navigator.language != 'en') {       
  doLangSelect(window.navigator.language); 
}

Specifications

Specification Status Comentários
HTML 5.1
The definition of 'NavigatorLanguage.language' in that specification.
Recomendação Definição inicial

Compatibilidade com navegadores

Estamos convertendo nossos dados de compatibilidade para o formato JSON. Esta tabela de compatibilidade ainda usa o formato antigo, pois ainda não convertemos os dados que ela contém. Descubra como você pode ajudar!

Feature Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Suporte básico (Yes)[1] (Yes) 1.0 (1.7 or earlier)[2]
5.0 (5.0)[3]
11.0[4] (Yes) (Yes)
on WorkerNavigator ? ? 35 (35) ? ? ?
Feature Android Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Suporte básico (Yes) (Yes) 1.0 (1.0) Não suportado[4] (Yes) (Yes)
on WorkerNavigator ? ? 35 (35) Não suportado ? ?

[1] Retorna a língua da interface do browser, não o valor do HTTP header Accept-Language .

[2] Antes do Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1), o valor dessa propriedade também fazia parte da string de user agent, como reportado em navigator.userAgent.

[3] Começando no Gecko 5.0 (Firefox 5.0 / Thunderbird 5.0 / SeaMonkey 2.2), o valor dessa propriedade é baseado no valor do HTTP header Accept-Language.

[4] As propriedades (não padronizadas) mais próximas disponíveis são userLanguage e browserLanguage.

Veja também

Etiquetas do documento e colaboradores

Colaboradores desta página: klzns
Última atualização por: klzns,