Intl.Locale.prototype.maximize()

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 Methode maximize() von Intl.Locale-Instanzen ermittelt die wahrscheinlichsten Werte für Sprache, Skript und Region dieser Locale basierend auf den bestehenden Werten.

Probieren Sie es aus

const english = new Intl.Locale("en");
const korean = new Intl.Locale("ko");
const arabic = new Intl.Locale("ar");

console.log(english.maximize().baseName);
// Expected output: "en-Latn-US"

console.log(korean.maximize().baseName);
// Expected output: "ko-Kore-KR"

console.log(arabic.maximize().baseName);
// Expected output: "ar-Arab-EG"

Syntax

js
maximize()

Parameter

Keine.

Rückgabewert

Eine Intl.Locale-Instanz, deren baseName-Eigenschaft das Ergebnis des Add Likely Subtags-Algorithmus zurückgibt, der auf locale.baseName ausgeführt wurde.

Beschreibung

Manchmal ist es praktisch, die wahrscheinlichsten Untertags eines Locale-Sprachidentifikators basierend auf einer unvollständigen Sprach-ID zu identifizieren. Der "Add Likely Subtags"-Algorithmus bietet uns diese Funktionalität. Zum Beispiel gibt der Algorithmus für die Sprach-ID "en" das Ergebnis "en-Latn-US" zurück, da Englisch nur im lateinischen Skript geschrieben werden kann und höchstwahrscheinlich in den Vereinigten Staaten verwendet wird, da dies das größte englischsprachige Land der Welt ist. Diese Funktionalität wird JavaScript-Programmierern über die Methode maximize() bereitgestellt. maximize() wirkt sich nur auf die Hauptuntertags aus, die den Sprachidentifikator bilden: Sprach-, Skript- und Regionsuntertags. Andere Untertags nach dem "-u" im Locale-Identifikator, sogenannte Erweiterungstags, werden durch die Methode maximize() nicht beeinflusst. Beispiele für diese Untertags sind hourCycle, calendar und numeric.

Beispiele

Verwendung von maximize

js
const myLocale = new Intl.Locale("fr", {
  hourCycle: "h12",
  calendar: "gregory",
});
console.log(myLocale.baseName); // Prints "fr"
console.log(myLocale.toString()); // Prints "fr-u-ca-gregory-hc-h12"
const myLocMaximized = myLocale.maximize();

// Prints "fr-Latn-FR". The "Latn" and "FR" tags are added,
// since French is only written in the Latin script and is most likely to be spoken in France.
console.log(myLocMaximized.baseName);

// Prints "fr-Latn-FR-u-ca-gregory-hc-h12".
// Note that the extension tags (after "-u") remain unchanged.
console.log(myLocMaximized.toString());

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch