---
title: NavigatorLanguage.languages
slug: Web/API/NavigatorLanguage/languages
tags:
  - API
  - languages
  - 只读
  - 实验性
  - 属性
translation_of: Web/API/NavigatorLanguage/languages
---
<p>{{APIRef("HTML DOM")}}{{SeeCompatTable}}</p>

<p><code><strong>NavigatorLanguage.languages </strong></code>只读属性 ，返回一个 {{domxref("DOMString")}} 的数组，数组内容表示网站访客所使用的语言。 使用 <a href="http://tools.ietf.org/html/bcp47">BCP 47</a> 语言标签来描述不同的语言。 在返回的数组中，最适合当前用户的语言将会被排到数组的首位。</p>

<p>{{domxref("NavigatorLanguage.language","navigator.language")}} 的值是该属性返回数组的第一个元素 [3]。（但它基于系统语言设置。）</p>

<p>当该值发生改变，即最适合用户的语言被改变， 事件{{event("languagechange")}} 将会在 {{domxref("Window")}} 对象下触发。</p>

<p>在每一个HTTP请求上的来自用户浏览器的HTTP协议头 <code>Accept-Language</code> 使用相同的来自 <code>navigator.languages</code> 属性的语言值，除了特殊的 <code>qvalues</code> （权重值） 字段 （如：<code>en-US;q=0.8）。</code></p>

<h2 id="语法">语法</h2>

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

<h2 id="例子">例子</h2>

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

<h2 id="标准">标准</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">标准</th>
   <th scope="col">状态</th>
   <th scope="col">备注</th>
  </tr>
  <tr>
   <td>{{ SpecName('HTML5.1', '#dom-navigator-languages', 'NavigatorLanguage.languages') }}</td>
   <td>{{ Spec2('HTML5.1') }}</td>
   <td>
    <p>初始化定义</p>
   </td>
  </tr>
 </tbody>
</table>

<h2 id="浏览器兼容性">浏览器兼容性</h2>



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

<h2 id="参见">参见</h2>

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