Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Intl.PluralRules.prototype.select(): wybór kategorii liczby mnogiej

Metoda `select(value)` zwraca kategorię gramatyczną jednej wartości na podstawie ustawień językowych i opcji instancji. Wynik służy do wyboru tłumaczenia, a nie do formatowania liczby.

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

Składnia

rules.select(value)

Intl.PluralRules.prototype.select to metoda instancji. Utwórz rules za pomocą new Intl.PluralRules(locales, options) i wywołaj rules.select(value). Wynik to jeden z napisów: "zero", "one", "two", "few", "many" lub "other". Dostępne kategorie zależą od wybranych ustawień językowych i typu reguł; "one" nie jest uniwersalnym testem value === 1. Użyj kategorii jako klucza do wariantu tłumaczenia: metoda nie tłumaczy tekstu ani nie formatuje liczby.

Typ "cardinal" jest domyślny i dotyczy liczebników głównych (ile?). Typ "ordinal" dotyczy liczebników porządkowych (który z kolei?). Zaokrąglanie i opcje cyfr, takie jak minimumFractionDigits, mogą zmienić kategorię, ponieważ reguły mogą uwzględniać widoczne cyfry po separatorze dziesiętnym. select klasyfikuje jedną wartość, a selectRange — cały zakres. Sprawdź faktycznie wybrane ustawienia językowe w rules.resolvedOptions().locale; środowisko może użyć innych niż żądane.

this musi być zainicjalizowaną instancją Intl.PluralRules. Wywołanie metody na samym prototypie lub wywołanie jej jako odłączonej funkcji bez powiązania z instancją kończy się TypeError. Zarówno w wydaniu ECMA-402 z 2024 r., jak i w aktualnym projekcie tej specyfikacji metoda select stosuje ToNumber: napisy liczbowe są konwertowane na wartości typu Number (np. "2" staje się 2), a wartości typu BigInt lub Symbol powodują TypeError. Pominięty argument staje się NaN; NaN i obie nieskończoności dają "other". Nie traktuj więc wyniku jako potwierdzenia poprawności danych wejściowych.

Przykłady

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

Wynik

one
other
two
other

Przy regułach angielskiego amerykańskiego wartość `2` daje `other` dla liczebnika głównego, a `two` dla porządkowego. Wymuszenie jednej cyfry po separatorze sprawia, że liczba `1` jest klasyfikowana jak `1.0`, więc daje `other` zamiast `one`.

Powiązane lekcje

  • JavaScript · Lekcja 24 · Zaawansowany · Wersja: 4

Źródła