Intl.Segmenter.supportedLocalesOf()

Baseline 2024

Newly available

Since April 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die statische Methode Intl.Segmenter.supportedLocalesOf() gibt ein Array zurück, das diejenigen der angegebenen Locales enthält, die in der Segmentierung unterstützt werden, ohne auf die Standard-Local der Laufzeitumgebung zurückfallen zu müssen.

Probieren Sie es aus

const locales1 = ["ban", "id-u-co-pinyin", "de-ID"];
const options1 = { localeMatcher: "lookup", granularity: "string" };

console.log(Intl.Segmenter.supportedLocalesOf(locales1, options1));
// Expected output: Array ["id-u-co-pinyin", "de-ID"]
// (Note: the exact output may be browser-dependent)

Syntax

Intl.Segmenter.supportedLocalesOf(locales)
Intl.Segmenter.supportedLocalesOf(locales, options)

Parameter

locales

Ein String mit einem BCP 47-Sprach-Tag oder ein Array solcher Strings. Für die allgemeine Form und Interpretation des locales-Arguments siehe die Parameterbeschreibung auf der Intl Hauptseite.

options Optional

Ein Objekt, das die folgende Eigenschaft haben kann:

localeMatcher: Der zu verwendende Locale-Abgleichsalgorithmus. Mögliche Werte sind "lookup" und "best fit"; der Standardwert ist "best fit". Informationen zu dieser Option finden Sie auf der Intl Seite.

Rückgabewert

Ein Array von Strings, das eine Teilmenge der gegebenen Locale-Tags darstellt, die in der Segmentierung unterstützt werden, ohne auf die Standard-Local der Laufzeitumgebung zurückfallen zu müssen.

Beispiele

Nutzung von supportedLocalesOf()

Angenommen, eine Laufzeitumgebung unterstützt Indonesisch und Deutsch, aber nicht Balinesisch in der Segmentierung, gibt supportedLocalesOf die indonesischen und deutschen Sprach-Tags unverändert zurück, obwohl die pinyin-Sortierung weder für die Segmentierung relevant noch mit Indonesisch verwendet wird und ein spezialisiertes Deutsch für Indonesien wahrscheinlich nicht unterstützt wird. Beachten Sie die Spezifizierung des "lookup"-Algorithmus hier — ein "best fit"-Matcher könnte entscheiden, dass Indonesisch eine angemessene Entsprechung für Balinesisch ist, da die meisten Balinesisch-Sprecher auch Indonesisch verstehen, und daher das balinesische Sprach-Tag ebenfalls zurückgeben.

const locales = ["ban", "id-u-co-pinyin", "de-ID"];
const options = { localeMatcher: "lookup" };
console.log(Intl.Segmenter.supportedLocalesOf(locales, options));
// ["id-u-co-pinyin", "de-ID"]

Spezifikationen

Specification
ECMAScript® 2025 Internationalization API Specification # sec-intl.segmenter.supportedlocalesof

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

Intl.Segmenter