Intl.ListFormat : méthode statique supportedLocalesOf()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis avril 2021.
La méthode statique supportedLocalesOf() des instances de Intl.ListFormat retourne un tableau contenant celles des locales fournies qui sont prises en charge pour le formatage des listes sans avoir à recourir à la locale par défaut de l'environnement d'exécution.
Syntaxe
Intl.ListFormat.supportedLocalesOf(locales)
Intl.ListFormat.supportedLocalesOf(locales, options)
Paramètres
locales-
Une chaîne de caractères avec une balise BCP 47 language tag, ou un tableau de telles chaînes. Pour la forme générale et l'interprétation de l'argument
locales, voir la description du paramètre sur la page principale deIntl. optionsFacultatif-
Un objet qui peut avoir la propriété suivante :
localeMatcher-
L'algorithme de correspondance de la locale à utiliser. Les valeurs possibles sont
"lookup"et"best fit"; la valeur par défaut est"best fit". Pour plus d'informations sur cette option, voir la page Intl.
Valeur de retour
Un tableau de chaînes de caractères représentant un sous-ensemble des balises de langue fournies qui sont prises en charge pour le formatage des listes sans avoir à recourir à la locale par défaut de l'environnement d'exécution.
Exemples
>Utiliser la méthode supportedLocalesOf()
En supposant un environnement d'exécution qui prend en charge le formatage des listes pour l'indonésien et l'allemand mais pas pour le balinais, supportedLocalesOf retourne les balises de langue pour l'indonésien et l'allemand sans modification, même si la collation pinyin n'est ni pertinente pour le formatage des listes ni utilisée avec l'indonésien, et qu'une version spécialisée de l'allemand pour l'Indonésie est peu probable. Notez la spécification de l'algorithme "lookup" ici — un appariement "best fit" pourrait considérer que l'indonésien est une correspondance adéquate pour le balinais puisque la plupart des locuteurs balinais comprennent aussi l'indonésien, et donc retourner également la balise de langue balinaise.
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"]
Spécifications
| Specification |
|---|
| ECMAScript® 2026 Internationalization API Specification> # sec-Intl.ListFormat.supportedLocalesOf> |
Compatibilité des navigateurs
Voir aussi
- L'objet
Intl.ListFormat