Intl.PluralRules.prototype.resolvedOptions()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2019.

Die resolvedOptions()-Methode der Intl.PluralRules-Instanzen gibt ein neues Objekt mit Eigenschaften zurück, die die während der Initialisierung dieses PluralRules-Objekts berechneten Optionen widerspiegeln.

Probieren Sie es aus

const pluralRules1 = new Intl.PluralRules("uk");
const options1 = pluralRules1.resolvedOptions();

const pluralRules2 = new Intl.PluralRules("bn");
const options2 = pluralRules2.resolvedOptions();

console.log(options1.pluralCategories);
// Expected output: Array ["few", "many", "one", "other"]

console.log(options2.pluralCategories);
// Expected output: Array ["one", "other"]

Syntax

resolvedOptions()

Parameter

Keine.

Rückgabewert

Ein neues Objekt mit Eigenschaften, die die während der Initialisierung dieses PluralRules-Objekts berechneten Optionen widerspiegeln. Das Objekt hat die folgenden Eigenschaften in der aufgeführten Reihenfolge:

locale: Der BCP 47-Sprachcode für die tatsächlich verwendete Locale, bestimmt durch den Locale-Verhandlungsprozess. Es wird kein Unicode-Erweiterungsschlüssel im Ausgabe enthalten sein.
type: Der für diese Eigenschaft im options-Argument angegebene Wert, mit Standardwerten ausgefüllt, wo erforderlich. Es ist entweder "cardinal" oder "ordinal". Der Standardwert ist "cardinal".
minimumIntegerDigits, minimumFractionDigits, maximumFractionDigits Optional: Der für diese Eigenschaften im options-Argument angegebene Wert, mit Standardwerten ausgefüllt, wo erforderlich. Diese Eigenschaften sind nur vorhanden, wenn weder minimumSignificantDigits noch maximumSignificantDigits im options-Argument angegeben wurden.
minimumSignificantDigits, maximumSignificantDigits Optional: Der für diese Eigenschaften im options-Argument angegebene Wert, mit Standardwerten ausgefüllt, wo erforderlich. Diese Eigenschaften sind nur vorhanden, wenn mindestens einer von ihnen im options-Argument angegeben wurde.
pluralCategories: Ein Array von Pluralkategorien, die von der angegebenen Locale verwendet werden, ausgewählt aus der Liste "zero", "one", "two", "few", "many" und "other".
roundingIncrement: Der für diese Eigenschaft im options-Argument angegebene Wert, mit Standardwerten ausgefüllt, wo erforderlich. Es ist einer von 1, 2, 5, 10, 20, 25, 50, 100, 200, 250, 500, 1000, 2000, 2500 und 5000. Der Standardwert ist 1.
roundingMode: Der für diese Eigenschaft im options-Argument angegebene Wert, mit Standardwerten ausgefüllt, wo erforderlich. Es ist einer von "ceil", "floor", "expand", "trunc", "halfCeil", "halfFloor", "halfExpand", "halfTrunc" und "halfEven". Der Standardwert ist "halfExpand".
roundingPriority: Der für diese Eigenschaft im options-Argument angegebene Wert, mit Standardwerten ausgefüllt, wo erforderlich. Es ist entweder "auto", "morePrecision" oder "lessPrecision". Der Standardwert ist "auto".
trailingZeroDisplay: Der für diese Eigenschaft im options-Argument angegebene Wert, mit Standardwerten ausgefüllt, wo erforderlich. Es ist entweder "auto" oder "stripIfInteger". Der Standardwert ist "auto".

Beispiele

Verwendung der Methode resolvedOptions()

Der folgende Code zeigt die Konstruktion eines PluralRules-Objekts, gefolgt von der Ausgabe jeder der aufgelösten Optionen.

// Create a PluralRules instance
const de = new Intl.PluralRules("de-DE", {
  maximumSignificantDigits: 2,
  trailingZeroDisplay: "auto",
});

// Resolve the options
const usedOptions = de.resolvedOptions();
console.log(usedOptions.locale); // "de-DE"
console.log(usedOptions.pluralCategories); // Array ["one", "other"]
console.log(usedOptions.type); // "cardinal"
console.log(usedOptions.minimumIntegerDigits); // 1
console.log(usedOptions.minimumFractionDigits); // undefined (maximumSignificantDigits is set)
console.log(usedOptions.maximumFractionDigits); // undefined (maximumSignificantDigits is set)
console.log(usedOptions.minimumSignificantDigits); // 1
console.log(usedOptions.maximumSignificantDigits); // 2
console.log(usedOptions.roundingIncrement); // 1
console.log(usedOptions.roundingMode); // "halfExpand"
console.log(usedOptions.roundingPriority); // "auto"
console.log(usedOptions.trailingZeroDisplay); // "auto"

Spezifikationen

Specification
ECMAScript® 2026 Internationalization API Specification # sec-intl.pluralrules.prototype.resolvedoptions

Browser-Kompatibilität

Siehe auch

Intl.PluralRules