Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Intl.PluralRules.prototype.select(): scegliere una categoria di plurale

`select(value)` restituisce la categoria grammaticale di un valore in base alla lingua e alle opzioni dell’istanza. Il risultato serve a scegliere un messaggio tradotto, non a formattare un numero.

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

Sintassi

rules.select(value)

Intl.PluralRules.prototype.select è un metodo di istanza. Crea rules con new Intl.PluralRules(locales, options), poi chiama rules.select(value). Il risultato è una delle stringhe "zero", "one", "two", "few", "many" o "other". Le categorie disponibili dipendono dalle impostazioni locali effettive e dal tipo di regola; "one" non equivale sempre a value === 1. Usa la categoria come chiave per scegliere una variante tradotta: il metodo non traduce il testo né formatta il numero.

Il tipo predefinito "cardinal" indica la quantità («quanti?»); "ordinal" indica la posizione («in quale posizione?»). L’arrotondamento e opzioni come minimumFractionDigits possono cambiare la categoria, perché le regole possono dipendere dalle cifre decimali visibili. select classifica un singolo valore; selectRange classifica un intero intervallo. Controlla rules.resolvedOptions().locale per sapere quali impostazioni locali sono state usate: possono differire da quelle richieste.

Il ricevitore (this) deve essere un’istanza inizializzata di Intl.PluralRules. Chiamare il metodo sul prototipo stesso o come funzione separata e non associata all’istanza genera TypeError. Sia nell’edizione 2024 di ECMA-402 sia nella bozza attuale, select usa ToNumber: le stringhe numeriche vengono convertite in valori di tipo Number ("2" diventa 2), mentre BigInt e Symbol generano TypeError. Un argomento omesso diventa NaN; NaN ed entrambi gli infiniti restituiscono "other". Il fatto che venga restituita una categoria non convalida quindi l’input.

Esempi

{
  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));
}

Risultato

one
other
two
other

Con le regole dell’inglese statunitense, `2` dà `other` come cardinale e `two` come ordinale. Richiedere una cifra decimale fa classificare `1` come `1.0`, che restituisce `other` anziché `one`.

Lezioni correlate

  • JavaScript · Lezione 24 · Avanzato · Versione: 4

Fonti