Navigator.languages
Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。
navigator.languages
は読み取り専用プロパティで、ユーザーの推奨される言語を表す DOMString
の配列を返します。この言語は BCP 47 言語タグを使用して記述されています。返された配列の中では、設定で最も推奨される言語が最初に来るように並べられています。
navigator.language
の値は返される配列の最初の要素です。
この値を変更すると、ユーザーの推奨言語が変更され、 languagechange (en-US)
イベントが Window
オブジェクトに発行されます。
ユーザーのブラウザーからのすべての HTTP リクエストにある Accept-Language
ヘッダーは、 navigator.languages
プロパティと同じ値ですが、拡張された qvalues
(quality values) フィールドのみが異なります (例えば en-US;q=0.8
)。
構文
preferredLanguages = globalObj.navigator.languages
例
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