Intl.Locale.prototype.language

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2020.

Die language-Zugriffseigenschaft von Intl.Locale-Instanzen gibt die Sprache zurück, die mit dieser Lokalisierung verbunden ist.

Beschreibung

Die Sprache ist eines der Kerneigenschaften einer Lokalisierung. Die Unicode-Spezifikation behandelt den Sprachbezeichner einer Lokalisierung als Kombination aus Sprache und Region (um Unterschiede zwischen Dialekten und Varianten zu kennzeichnen, z. B. Britisches Englisch vs. Amerikanisches Englisch). Die language-Eigenschaft eines Intl.Locale gibt streng genommen nur das Sprachsubtag der Lokalisierung zurück. Der Wert der language-Eigenschaft wird zur Zeitpunkt der Erstellung festgelegt, entweder durch das language-Subtag (erster Teil) der Lokalisierungskennung oder durch die language-Option des Intl.Locale()-Konstruktors. Letztere hat Priorität, wenn beide vorhanden sind.

Der Set-Accessor von language ist undefined. Sie können diese Eigenschaft nicht direkt ändern.

Beispiele

Wie andere Lokalisierungs-Subtags kann die Sprache dem Intl.Locale-Objekt über den Lokalisierungs-String oder ein Konfigurationsobjekt-Argument für den Konstruktor hinzugefügt werden.

Festlegen der Sprache über den Lokalisierungs-String

Um ein gültiger Unicode-Lokalisierungsbezeichner zu sein, muss ein String mit dem Sprachsubtag beginnen. Das Hauptargument für den Intl.Locale()-Konstruktor muss ein gültiger Unicode-Lokalisierungsbezeichner sein, sodass beim Gebrauch des Konstruktors ein Bezeichner mit einem Sprachsubtag übergeben werden muss.

js
const locale = new Intl.Locale("en-Latn-US");
console.log(locale.language); // Prints "en"

Überschreiben der Sprache via Konfigurationsobjekt-Argument

Während das Sprachsubtag spezifiziert werden muss, hat der Intl.Locale()-Konstruktor ein optionales Konfigurationsobjekt-Argument, das das Sprachsubtag überschreiben kann.

js
const locale = new Intl.Locale("en-Latn-US", { language: "es" });
console.log(locale.language); // Prints "es"

Spezifikationen

Specification
ECMAScript® 2025 Internationalization API Specification
# sec-Intl.Locale.prototype.language

Browser-Kompatibilität

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
language

Legend

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

Full support
Full support

Siehe auch