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
# dom-navigator-languages-dev

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
languages

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
See implementation notes.

関連情報