Die schreibgeschütztelanguages-Eigenschaft desNavigator-Interfacesgibt ein Array von Strings zurück, die die bevorzugtenSprachen des Benutzers darstellen. Die Sprache wird mit einemBCP 47-Sprachtag beschrieben. Im zurückgegebenenArray sind sie nach Präferenz geordnet, wobei die am meisten bevorzugte Sprache zuerst erscheint.

Der Wert vonnavigator.language ist daserste Element des zurückgegebenen Arrays.

Wenn sich der Wert ändert, beispielsweise wenn die bevorzugten Sprachen des Benutzers geändert werden, wird einlanguagechange-Ereignis auf demWindow-Objekt ausgelöst.

DerAccept-Language HTTP-Header in jeder HTTP-Anfrage des Browsers des Benutzers listet im Allgemeinen die gleichen Locale wie dienavigator.languages-Eigenschaft auf, mit abnehmendenq-Werten (Qualitätswerte). Einige Browser (Chrome und Safari) fügen imAccept-Language-Header Sprachtags ohne Länderkennzeichnung als Fallback hinzu—zum Beispielen-US,en;q=0.9,zh-CN;q=0.8,zh;q=0.7, wennnavigator.languages["en-US", "zh-CN"] ist. Aus Datenschutzgründen (Reduzierung vonFingerprinting) können sowohlAccept-Language als auchnavigator.languages möglicherweise nicht die vollständige Liste der Benutzerpräferenzen enthalten, wie zum Beispiel in Safari (immer) und im Inkognito-Modus von Chrome, wo nur eine Sprache aufgelistet ist.

Wert

Ein Array von Strings.

Beispiele

Auflisten der Inhalte von navigator.language und navigator.languages

navigator.language; // "en-US"navigator.languages; // ["en-US", "zh-CN", "ja-JP"]

Verwenden von Intl-Konstruktoren für sprachspezifische Formatierung mit Fallback

Das Array von Sprachkennungen, das innavigator.languages enthalten ist, kann direkt an dieIntl-Konstruktoren übergeben werden, um eine präferenzbasierte Fallbackauswahl von Locales zu implementieren, bei der der erste Eintrag in der Liste verwendet wird, der eine vonIntl unterstützte Locale entspricht:

const date = new Date("2012-05-24");const formattedDate = new Intl.DateTimeFormat(navigator.languages).format(date);

Spezifikationen

Browser-Kompatibilität

Siehe auch

• navigator.language
• navigator
• languagechange Ereignis
• Intl