@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 converts to 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 data

data: T;

property locale

locale: Locale;

property maximumFractionDigits

maximumFractionDigits: number;

property maximumSignificantDigits

maximumSignificantDigits: number;

property minimumFractionDigits

minimumFractionDigits: number;

property minimumIntegerDigits

minimumIntegerDigits: number;

property minimumSignificantDigits

minimumSignificantDigits: number;

property notation

notation: NumberFormatNotation;

property roundingIncrement

roundingIncrement: number;

property roundingMode

roundingMode: RoundingModeType;

property roundingPriority

roundingPriority: RoundingPriorityType;

property roundingType

roundingType: NumberFormatRoundingType;

property trailingZeroDisplay

trailingZeroDisplay: TrailingZeroDisplay;

property cardinal

cardinal?: Record<string, LDMLPluralRule>;

property ordinal

ordinal?: Record<string, LDMLPluralRule>;

property categories

categories: {
    cardinal: string[];
    ordinal: string[];
};

property compactExponents

compactExponents?: CompactExponentData;

property fn

fn: (val: number | string, ord?: boolean, exponent?: number) => LDMLPluralRule;

property pluralRanges

pluralRanges?: PluralRangesData;

property compactDisplay

compactDisplay?: 'short' | 'long';

property compactExponents

compactExponents?: CompactExponentData;

property initializedPluralRules

initializedPluralRules: boolean;

property locale

locale: string;

property notation

notation: 'standard' | 'scientific' | 'engineering' | 'compact';

property type

type: 'cardinal' | 'ordinal';