---
title: NavigatorLanguage.languages
slug: Web/API/NavigatorLanguage/languages
translation_of: Web/API/NavigatorLanguage/languages
---
<p>{{APIRef("HTML DOM")}}{{SeeCompatTable}}</p>

<p>La propriété en lecture seule <code><strong>NavigatorLanguage.languages</strong></code> retourne un tableau de {{domxref("DOMString")}} représentant les langues préférées de l'utilisateur. Les étiquettes de langue utilisent les étiquettes de langages défini par <a href="http://tools.ietf.org/html/bcp47">BCP 47</a>. Le tableau retourné est trié par ordre de préférence décroissante (la langue préférée en premier).</p>

<p>La valeur de {{domxref("NavigatorLanguage.language","navigator.language")}} est le premier élément du tableau retourné.</p>

<p>Quant la valeur change, notamment lorsque l'utilisateur modifie ses préférences de langues, un événement {{event("languagechange")}} est déclenché sur l'objet {{domxref("Window")}}.</p>

<p>L'entête HTTP <code>Accept-Language</code> présent dans chaque requête HTTP issu de la navigation de l'utilisateur contient les mêmes valeurs que <code>navigator.languages</code>, avec en plus un champ <code>qvalues</code> (<em>valeur de qualité</em>), par exemple: <code>en-US;q=0.8</code>.</p>

<h2 id="Syntaxe">Syntaxe</h2>

<pre class="syntaxbox notranslate"><em>preferredLanguages</em> = <em>globalObj</em>.navigator.languages
</pre>

<h2 id="Exemples">Exemples</h2>

<pre class="brush: js notranslate">navigator.language   //"en-US"
navigator.languages  //["en-US", "zh-CN", "ja-JP"]
</pre>

<h2 id="Spécifications">Spécifications</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Spécifications</th>
   <th scope="col">Status</th>
   <th scope="col">Commentaire</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('HTML WHATWG', '#dom-navigator-languages', 'NavigatorLanguage: languages')}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td>Définition initiale</td>
  </tr>
 </tbody>
</table>

<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>



<p>{{Compat("api.NavigatorLanguage.languages")}}</p>

<h2 id="See_also" name="See_also">Voir aussi</h2>

<ul>
 <li>{{domxref("NavigatorLanguage.language","navigator.language")}}</li>
 <li>{{domxref("Navigator")}}</li>
 <li>{{domxref("Window.onlanguagechange")}}</li>
</ul>