Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Intl.PluralRules : 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 2019.

La méthode statique Intl.PluralRules.supportedLocalesOf() retourne un tableau contenant les locales fournies qui sont prises en charge pour les règles de pluriel, sans avoir à revenir à la locale par défaut de l'environnement d'exécution.

Exemple interactif

const locales = ["en-US", "ban", "ar-OM", "de-DE"];
const options = { localeMatcher: "lookup" };

console.log(Intl.PluralRules.supportedLocalesOf(locales, options));
// Résultat attendu : Array ["en-US", "ar-OM", "de-DE"]

Syntaxe

js
Intl.PluralRules.supportedLocalesOf(locales)
Intl.PluralRules.supportedLocalesOf(locales, options)

Paramètres

locales

Une chaîne de caractères représentant une balise de langue BCP 47, ou un tableau de telles chaînes de caractères. Pour la forme générale et l'interprétation de l'argument locales, voir la description des paramètres sur la page principale de Intl.

options Facultatif

Un objet pouvant contenir la propriété suivante :

localeMatcher

L'algorithme de correspondance de locale à utiliser. Les valeurs possibles sont "lookup" et "best fit" ; la valeur par défaut est "best fit". Pour des 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 les règles de pluriel, 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 prenant en charge l'indonésien et l'allemand mais pas le balinais pour les règles de pluriel, supportedLocalesOf retourne les balises de langue indonésienne et allemande inchangées, même si la collation pinyin n'est ni pertinente pour les règles de pluriel ni utilisée avec l'indonésien, et qu'une variante allemande pour l'Indonésie est peu susceptible d'être prise en charge. Notez la spécification de l'algorithme "lookup" ici — une correspondance "best fit" peut 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 retourner donc également la balise de langue balinaise.

js
const locales = ["ban", "id-u-co-pinyin", "de-ID"];
const options = { localeMatcher: "lookup" };
console.log(Intl.PluralRules.supportedLocalesOf(locales, options));
// ["id-u-co-pinyin", "de-ID"]

Spécifications

Spécification
ECMAScript® 2027 Internationalization API Specification
# sec-intl.pluralrules.supportedlocalesof

Compatibilité des navigateurs

Voir aussi