Navigator: languages プロパティ
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.
Navigator.languages
は読み取り専用プロパティで、ユーザーの推奨される言語を表す文字列の配列を返します。この言語は RFC 5646: Tags for Identifying Languages (also known as BCP 47) による言語タグを使用して記述されています。返された配列の中では、設定で最も推奨される言語が最初に来るように並べられています。
navigator.language
の値は返される配列の最初の要素です。
この値を変更すると、ユーザーの推奨言語が変更され、 languagechange
イベントが Window
オブジェクトに発行されます。
ユーザーのブラウザーからのすべての HTTP リクエストにある Accept-Language
ヘッダーは、 navigator.languages
プロパティと同じ値ですが、拡張された qvalues
(quality values) フィールドのみが異なります (例えば en-US;q=0.8
)。
値
文字列です。
例
js
navigator.language; //"en-US"
navigator.languages; //["en-US", "zh-CN", "ja-JP"]
仕様書
Specification |
---|
HTML Standard # dom-navigator-languages-dev |
ブラウザーの互換性
BCD tables only load in the browser