La méthode Intl.Collator.supportedLocalesOf()
renvoie, parmi les locales fournies, un tableau contenant les locales supportées et qui ne nécessitent pas d'utiliser la locale par défaut de l'environnement.
Syntaxe
Intl.Collator.supportedLocalesOf(locales [, options])
Paramètres
locales
- Une chaîne de caractères qui est une balise de langue BCP 47 ou bien un tableau de telles chaînes. Pour plus d'informations concernant la forme générale de l'argument
locales
, voir la pageIntl
. options
-
Paramètre facultatif. Un objet qui peut posséder les propriétés suivantes :
localeMatcher
-
L'algorithme utilisé pour la correspondance entre chaînes de caractères. Les valeurs possibles sont
"lookup"
et"best fit"
. La valeur par défaut est"best fit"
. Pour plus d'informations, voir la pageIntl
.
Valeur de retour
Un tableau de chaînes de caractères qui représente un sous-ensemble des balises de langues qui sont prises en charge pour la collation sans qu'il faille utiliser la locale par défaut de l'environnement d'exécution.
Description
Cette méthode renvoie un tableau qui est un sous-ensemble des balises de locales fournies avec l'argument locales
. Les balises renvoyées sont celles supportées par l'environnement navigateur en termes de collation (comparaison) et qui ne nécessitent pas d'utiliser la locale par défaut.
Exemple
Utiliser supportedLocalesOf
Si on dispose d'un environnement (un navigateur par exemple) qui supporte la comparaison de chaînes dans les locales indonésienne, allemande mais pas balinaise, supportedLocalesOf
renvoie les balises pour l'indonésien et l'allemand quand bien même la collation avec pinyin n'est pas utilisée avec l'indonésien et qu'il n'existe pas une version spécifique de l'allemand pour l'Indonésie. On illustre ici l'algorithme "lookup"
. SI on utilisait "best fit"
pour trouver les locales correspondantes, on aurait pu avoir une balise supplémentaire pour le balinais en plus car la plupart des balinais comprennent l'indonésien.
var locales = ["ban", "id-u-co-pinyin", "de-ID"]; var options = {localeMatcher: "lookup"}; console.log(Intl.Collator.supportedLocalesOf(locales, options).join(", ")); // → "id-u-co-pinyin, de-ID"
Spécifications
Compatibilité des navigateurs
Fonctionnalité | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Support simple | 24 | 29 (29) | 11 | 15 | Pas de support |
Fonctionnalité | Android | Chrome pour Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Support simple | Pas de support | 26 | Pas de support | Pas de support | Pas de support | Pas de support |