Intl.Locale : méthode getCollations()
Disponibilité limitée
Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.
La méthode getCollations() des instances de Intl.Locale retourne une liste d'un ou plusieurs types de collation (angl.) pour cette locale.
Note :
Dans certaines versions de certains navigateurs, cette méthode était implémentée comme une propriété d'accesseur appelée collations. Cependant, comme elle retourne un nouveau tableau à chaque accès, elle est maintenant implémentée comme une méthode pour éviter la situation où locale.collations === locale.collations retourne false. Consultez le tableau de compatibilité des navigateurs pour plus de détails.
Syntaxe
getCollations()
Paramètres
Aucun.
Valeur de retour
Un tableau de chaînes de caractères représentant tous les types de collation couramment utilisés pour la Locale, triés par ordre alphabétique, les valeurs standard et search étant toujours exclues. Si la Locale possède déjà une collation, alors le tableau retourné contient cette seule valeur.
Pour une liste des types de collation pris en charge, voir Intl.supportedValuesOf().
Exemples
Obtenir les types de collation pris en charge
Si l'objet Locale ne possède pas déjà un collation, getCollations() liste tous les types de collation couramment utilisés pour la Locale donnée. Pour des exemples de définition explicite d'un collation, voir les exemples de collation.
const locale = new Intl.Locale("zh");
console.log(locale.getCollations()); // ["pinyin", "stroke", "zhuyin", "emoji", "eor"]
Spécifications
| Spécification |
|---|
| Intl Locale Info Proposal # sec-Intl.Locale.prototype.getCollations |
Compatibilité des navigateurs
Voir aussi
- L'objet
Intl.Locale - La propriété
Intl.Locale.prototype.collation