База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Intl.PluralRules.prototype.select(): избор на категория за множествено число

`select(value)` връща граматична категория за една стойност според езиковата настройка и опциите на инстанцията. Резултатът служи за избор на преведен текст, а не за форматиране на число.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

rules.select(value)

Intl.PluralRules.prototype.select е метод на инстанция. Създайте rules с new Intl.PluralRules(locales, options) и извикайте rules.select(value). Методът връща един от низовете "zero", "one", "two", "few", "many" или "other". Достъпните категории зависят от действително използваната езикова настройка и вида на правилата; "one" не е универсална проверка за value === 1. Използвайте категорията като ключ за избор на преведен вариант на съобщението: методът не превежда текст и не форматира число.

Типът по подразбиране "cardinal" се отнася до бройни числителни („колко?“), а "ordinal" — до редни числителни („кой по ред?“). Закръгляването и опции като minimumFractionDigits могат да променят категорията, защото правилата могат да зависят от видимите цифри след десетичния разделител. select класифицира една стойност, а selectRange — цял диапазон. Проверете rules.resolvedOptions().locale, за да видите действително използваната езикова настройка, която може да се различава от заявената.

this трябва да е инициализирана инстанция на Intl.PluralRules. Извикването върху самия прототип или като отделена функция без обвързване с инстанцията предизвиква TypeError. Както в изданието на ECMA-402 от 2024 г., така и в текущия проект методът select използва ToNumber: числовите низове се преобразуват в стойности от тип Number ("2" става 2), а BigInt и Symbol предизвикват TypeError. Пропуснат аргумент става NaN; NaN и двете безкрайности връщат "other". Следователно върнатата категория не потвърждава валидността на входа.

Примери

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

Резултат

one
other
two
other

Според правилата на американския английски `2` връща `other` като бройно числително и `two` като редно. Ако изискате една цифра след десетичния разделител, `1` се класифицира като `1.0` и връща `other` вместо `one`.

Свързани уроци

  • JavaScript · Урок 24 · Напреднало · Версия: 4

Източници