Intl.Locale.prototype.region

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 region Zugriffseigenschaft von Intl.Locale Instanzen gibt die Region der Welt (normalerweise ein Land) zurück, die mit diesem Gebietsschema verknüpft ist.

Beschreibung

Die Region ist eines der Kernelemente eines Gebietsschemas. Sie ermöglicht die Auswahl von Unterschieden innerhalb derselben Sprache in verschiedenen Ländern. Zum Beispiel wird Englisch sowohl im Vereinigten Königreich als auch in den Vereinigten Staaten von Amerika gesprochen, aber es gibt Unterschiede in der Rechtschreibung und anderen Sprachkonventionen zwischen diesen beiden Ländern. Wenn JavaScript-Programmierer das Gebietsschema einer Region kennen, können sie sicherstellen, dass der Inhalt ihrer Websites und Anwendungen korrekt angezeigt wird, wenn er aus verschiedenen Teilen der Welt betrachtet wird.

Der Wert der region-Eigenschaft wird zur Konstruktion festgelegt, entweder durch den Teil des Gebietsschema-Identifiers nach script oder durch die region-Option des Intl.Locale() Konstruktors. Letzteres hat Vorrang, wenn beide vorhanden sind; und wenn keines von beiden vorhanden ist, hat die Eigenschaft den Wert undefined.

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

Beispiele

Wie andere Gebietsschema-Unterkennungen kann die Region über den Gebietsschema-String oder ein Konfigurationsobjektargument zum Konstruktor zum Intl.Locale-Objekt hinzugefügt werden.

Hinzufügen einer Region über den Gebietsschema-String

Die Region, wenn sie vorhanden ist, ist der dritte Teil (wenn script vorhanden ist, sonst der zweite Teil) einer gültigen Unicode-Sprachidentifier-Zeichenfolge und kann dem anfänglichen Gebietsschema-Identifier-String hinzugefügt werden, der in den Intl.Locale() Konstruktor übergeben wird. Beachten Sie, dass die Region kein erforderlicher Teil eines Gebietsschema-Identifiers ist.

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

Hinzufügen einer Region über das Konfigurationsobjektargument

Der Intl.Locale() Konstruktor hat ein optionales Konfigurationsobjektargument. Setzen Sie die region-Eigenschaft des Konfigurationsobjekts auf Ihre gewünschte Region und übergeben Sie sie dann in den Konstruktor.

js
const locale = new Intl.Locale("fr-Latn", { region: "FR" });
console.log(locale.region); // "FR"

Spezifikationen

Specification
ECMAScript® 2026 Internationalization API Specification
# sec-Intl.Locale.prototype.region

Browser-Kompatibilität

Siehe auch