Intl.NumberFormat : méthode statique supportedLocalesOf()
Baseline
Large disponibilité
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2017.
La méthode statique Intl.NumberFormat.supportedLocalesOf() retourne un tableau contenant les locales fournies qui sont prises en charge pour le formatage des nombres sans avoir à revenir à la locale par défaut de l'environnement d'exécution.
Exemple interactif
const locales = ["ban", "id-u-co-pinyin", "de-ID"];
const options = { localeMatcher: "lookup" };
console.log(Intl.NumberFormat.supportedLocalesOf(locales, options));
// Résultat attendu : Array ["id-u-co-pinyin", "de-ID"]
// (Remarque : le résultat exact peut dépendre du navigateur)
Syntaxe
Intl.NumberFormat.supportedLocalesOf(locales)
Intl.NumberFormat.supportedLocalesOf(locales, options)
Paramètres
locales-
Une chaîne de caractères qui est une balise de langue BCP 47, ou un tableau de telles chaînes de caractères. Pour plus d'informations sur la forme générale 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 des locales à 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 langues fournies qui sont prises en charge pour le formatage des nombres sans avoir à revenir à 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 l'indonésien et l'allemand mais pas le balinais pour le formatage des nombres, supportedLocalesOf retourne les balises de langue indonésienne et allemande inchangées, même si la collation pinyin n'est ni pertinente pour le formatage des nombres ni utilisée avec l'indonésien, et qu'un allemand spécialisé pour l'Indonésie est peu susceptible d'être pris en charge. Notez la spécification de l'algorithme "lookup" ici — une correspondance "best fit" pourrait décider que l'indonésien est une correspondance adéquate pour le balinais, puisque la plupart des locuteurs balinais comprennent également 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.NumberFormat.supportedLocalesOf(locales, options));
// ["id-u-co-pinyin", "de-ID"]
Spécifications
| Spécification |
|---|
| ECMAScript® 2027 Internationalization API Specification> # sec-intl.numberformat.supportedlocalesof> |
Compatibilité des navigateurs
Voir aussi
- L'objet
Intl.NumberFormat