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

関連情報