Intl.DisplayNames.supportedLocalesOf()

Baseline Widely available

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

Die statische Methode Intl.DisplayNames.supportedLocalesOf() gibt ein Array zurück, das diejenigen der bereitgestellten Gebietsschemas enthält, die in Anzeigennamen unterstützt werden, ohne auf das Standardsystem-Locale zurückgreifen zu müssen.

Syntax

js
Intl.DisplayNames.supportedLocalesOf(locales)
Intl.DisplayNames.supportedLocalesOf(locales, options)

Parameter

locales

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

options Optional

Ein Objekt, das die folgende Eigenschaft haben kann:

localeMatcher

Der zu verwendende Algorithmus für die Gebietsschema-Abstimmung. Mögliche Werte sind "lookup" und "best fit"; der Standardwert ist "best fit". Informationen über diese Option finden Sie auf der Intl Seite.

Rückgabewert

Ein Array von Strings, das eine Teilmenge der gegebenen Locale-Tags darstellt, die in Anzeigennamen unterstützt werden, ohne auf das Standardsystem-Locale zurückgreifen zu müssen.

Beispiele

Verwendung von supportedLocalesOf()

Angenommen, eine Laufzeitumgebung unterstützt Indonesisch und Deutsch, aber nicht Balinesisch in Anzeigennamen, gibt supportedLocalesOf die indonesischen und deutschen Sprach-Tags unverändert zurück, auch wenn pinyin-Kollation weder für Anzeigennamen relevant noch in Verbindung mit Indonesisch verwendet wird, und ein spezialisiertes Deutsch für Indonesien wahrscheinlich nicht unterstützt wird. Beachten Sie die Angabe des "lookup"-Algorithmus hier – ein "best fit" Matcher könnte entscheiden, dass Indonesisch eine ausreichende Übereinstimmung für Balinesisch ist, da die meisten Balinesen auch Indonesisch verstehen, und daher das balinesische Sprach-Tag ebenfalls zurückgeben.

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

Spezifikationen

Specification
ECMAScript® 2025 Internationalization API Specification
# sec-Intl.DisplayNames.supportedLocalesOf

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
supportedLocalesOf

Legend

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

Full support
Full support

Siehe auch