Intl.DisplayNames : méthode statique supportedLocalesOf()

Syntaxe

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

Paramètres

locales

Une chaîne de caractères contenant une balise de langue BCP 47 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 de Intl.

options Facultatif

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 qui est un sous-ensemble des balises de langue passées en argument et qui sont prises en charge pour les noms d'affichage 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 l'indonésien et l'allemand mais pas le balinais pour les noms d'affichage, supportedLocalesOf retourne les balises de langue indonésiennes et allemandes inchangées, même si la collation pinyin n'est ni pertinente pour les noms d'affichage 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 — un sélecteur "best fit" pourrait décider que l'indonésien est une correspondance acceptable pour le balinais puisque la plupart des locuteurs balinais comprennent également l'indonésien, et renvoyerait donc aussi la balise de langue balinaise.

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"]

Spécifications

Compatibilité des navigateurs

Voir aussi

• L'objet Intl.DisplayNames