Intl.ListFormat.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.ListFormat.supportedLocalesOf()
gibt ein Array zurück, das diejenigen der angegebenen Sprachräume enthält, die in der Listenformatierung unterstützt werden, ohne auf die Standardsprache des Laufzeitsystems zurückgreifen zu müssen.
Syntax
Intl.ListFormat.supportedLocalesOf(locales)
Intl.ListFormat.supportedLocalesOf(locales, options)
Parameter
locales
-
Ein String mit einem BCP 47-Sprachcode oder ein Array solcher Strings. Für die allgemeine Form und Interpretation des
locales
-Arguments siehe die Parameterbeschreibung auf der Hauptseite vonIntl
. options
Optional-
Ein Objekt, das die folgende Eigenschaft haben kann:
localeMatcher
-
Der Algorithmus zur Sprachauswahl, der verwendet werden soll. Mögliche Werte sind
"lookup"
und"best fit"
; der Standardwert ist"best fit"
. Für Informationen zu dieser Option siehe die Intl-Seite.
Rückgabewert
Ein Array von Strings, die eine Teilmenge der gegebenen Sprachraum-Tags darstellen, die in der Listenformatierung unterstützt werden, ohne auf die Standardsprache des Laufzeitsystems zurückgreifen zu müssen.
Beispiele
Verwendung von supportedLocalesOf()
Angenommen, eine Laufzeitumgebung unterstützt Indonesisch und Deutsch, aber nicht Balinesisch in der Listenformatierung, gibt supportedLocalesOf
die indonesischen und deutschen Sprachraum-Tags unverändert zurück, obwohl die pinyin
-Sortierung weder für die Listenformatierung relevant ist noch mit Indonesisch verwendet wird, und ein spezielles 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 angemessene Entsprechung für Balinesisch ist, da die meisten Balinesischsprechenden auch Indonesisch verstehen, und somit das balinesische Sprachraum-Tag ebenfalls zurückgeben.
const locales = ["ban", "id-u-co-pinyin", "de-ID"];
const options = { localeMatcher: "lookup" };
console.log(Intl.ListFormat.supportedLocalesOf(locales, options));
// ["id-u-co-pinyin", "de-ID"]
Spezifikationen
Specification |
---|
ECMAScript Internationalization API Specification # sec-Intl.ListFormat.supportedLocalesOf |
Browser-Kompatibilität
BCD tables only load in the browser