Navigator.language

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.

io error: No such file or directory (os error 2) (/home/runner/work/yari/yari/mdn/translated-content/files/fr/web/api/html_dom_api/index.md)

La propriété en lecture seule Navigator.language renvoie une chaîne de caractères qui représente la langue préférée de l'utilisatrice ou de l'utilisateur. Il s'agit généralement de la langue utilisée pour l'interface utilisateur du navigateur.

Valeur

Une chaîne de caractères DOMString. Le format de cette chaîne de caractères est défini par la RFC 5646, aussi connu sous le nom de balise BCP 47. Voici quelques exemples de codes de langue valides : "en", "en-US", "fr", "fr-FR", "es-ES", etc.

On notera que Safari pour iOS, avant la version 10.2, renvoyait le code du pays en minuscules : "en-us", "fr-fr", etc.

Exemples

js
if (/^en\b/.test(navigator.language)) {
  choisirLangue(window.navigator.language);
}

Spécifications

Specification
HTML Standard
# dom-navigator-language-dev

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi