@formatjs/intl-pluralrules

constructor

constructor(locales?: string | string[], options?: Intl.PluralRulesOptions);

property availableLocales

static availableLocales: Set<string>;

property localeData

static localeData: Record<string, PluralRulesData>;

property polyfilled

static polyfilled: boolean;

property relevantExtensionKeys

static relevantExtensionKeys: never[];

method getDefaultLocale

static getDefaultLocale: () => string;

method resolvedOptions

resolvedOptions: () => Intl.ResolvedPluralRulesOptions;

method select

select: (val: number | bigint) => LDMLPluralRule;

method selectRange

selectRange: (start: number | bigint, end: number | bigint) => LDMLPluralRule;

• Intl.PluralRules.prototype.selectRange ( start, end )

  Returns a string indicating which plural rule applies to a range of numbers. This is useful for formatting ranges like "1-2 items" vs "2-3 items" where different languages have different plural rules for ranges.

  Specification: https://tc39.es/ecma402/#sec-intl.pluralrules.prototype.selectrange

  Parameter start

  The start value of the range (number or bigint)

  Parameter end

  The end value of the range (number or bigint)

  Returns

  The plural category for the range (zero, one, two, few, many, or other)

  Throws

  {TypeError} If start or end is undefined

  Throws

  {RangeError} If start or end is not a finite number (Infinity, NaN)

  Chrome's native implementation (as of early 2025) has a bug where it throws "Cannot convert a BigInt value to a number" when using BigInt arguments. This is a browser bug - the spec requires BigInt support. This polyfill handles BigInt correctly.

  Example 1

  const pr = new Intl.PluralRules('en'); pr.selectRange(1, 2); // "other" (English: "1-2 items") pr.selectRange(1, 1); // "one" (same value: "1 item")

  Example 2

  const prFr = new Intl.PluralRules('fr'); prFr.selectRange(0, 1); // "one" (French: "0-1 vue") prFr.selectRange(1, 2); // "other" (French: "1-2 vues")

  Example 3

  // BigInt support (spec-compliant, but Chrome has a bug as of early 2025) pr.selectRange(BigInt(1), BigInt(2)); // "other"

method supportedLocalesOf

static supportedLocalesOf: (
    locales?: string | string[],
    options?: Pick<Intl.PluralRulesOptions, 'localeMatcher'>
) => string[];

method toString

toString: () => string;

property compactDisplay

compactDisplay?: 'short' | 'long';

property dataLocaleData

dataLocaleData?: any;

property initializedPluralRules

initializedPluralRules: boolean;

property locale

locale: string;

property notation

notation: 'standard' | 'compact';

property type

type: 'cardinal' | 'ordinal';