Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Intl.PluralRules.prototype.select() : choisir une catégorie de pluriel

`select(value)` renvoie la catégorie grammaticale d’une valeur selon les paramètres régionaux et les options de l’instance. Le résultat sert à choisir une traduction, pas à formater un nombre.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

rules.select(value)

Intl.PluralRules.prototype.select est une méthode d’instance. Créez rules avec new Intl.PluralRules(locales, options), puis appelez rules.select(value). La méthode renvoie l’une des chaînes "zero", "one", "two", "few", "many" ou "other". Les catégories disponibles dépendent des paramètres régionaux retenus et du type de règles ; "one" n’est pas un test universel de value === 1. Utilisez la catégorie comme clé pour choisir une variante traduite : la méthode ne traduit pas de texte et ne formate pas de nombre.

Le type par défaut "cardinal" répond à « combien ? » ; "ordinal" répond à « à quel rang ? ». L’arrondi et les options de chiffres comme minimumFractionDigits peuvent modifier la catégorie, car les règles peuvent dépendre des chiffres visibles après le séparateur décimal. select classe une seule valeur ; selectRange classe un intervalle entier. Consultez rules.resolvedOptions().locale pour connaître les paramètres régionaux réellement utilisés, qui peuvent différer de ceux demandés.

Le receveur (this) doit être une instance initialisée de Intl.PluralRules. Un appel sur le prototype lui-même ou via une fonction extraite et non liée déclenche TypeError. Dans l’édition 2024 d’ECMA-402 comme dans le projet de spécification actuel, select applique ToNumber : les chaînes numériques sont converties en valeurs de type Number ("2" devient 2), tandis que les valeurs BigInt et Symbol déclenchent TypeError. Un argument omis devient NaN ; NaN et les deux infinis donnent "other". La catégorie renvoyée ne valide donc pas l’entrée.

Exemples

{
  const cardinal = new Intl.PluralRules('en-US');
  const ordinal = new Intl.PluralRules('en-US', { type: 'ordinal' });
  const withFraction = new Intl.PluralRules('en-US', { minimumFractionDigits: 1 });

  console.log(cardinal.select(1));
  console.log(cardinal.select(2));
  console.log(ordinal.select(2));
  console.log(withFraction.select(1));
}

Résultat

one
other
two
other

Avec les règles de l’anglais américain, `2` donne `other` comme cardinal et `two` comme ordinal. Imposer un chiffre après le séparateur décimal fait classer `1` comme `1.0` : le résultat est `other` plutôt que `one`.

Leçons associées

  • JavaScript · Leçon 24 · Avancé · Version : 4

Sources