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 von 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 Reihenfolge, in der sie aufgelistet sind:

locale: Das BCP 47-Sprach-Tag für das tatsächlich verwendete Locale, bestimmt durch den Locale-Aushandlungsprozess. Kein Unicode-Erweiterungsschlüssel wird in der Ausgabe enthalten sein.
type: Der für diese Eigenschaft im options-Argument angegebene Wert, mit standardmäßig ausgefüllten Lücken. 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 standardmäßig ausgefüllten Lücken. 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 standardmäßig ausgefüllten Lücken. Diese Eigenschaften sind nur vorhanden, wenn mindestens eine von ihnen im options-Argument angegeben wurde.
pluralCategories: Ein Array von Pluralkategorien, die von dem 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 standardmäßig ausgefüllten Lücken. 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 standardmäßig ausgefüllten Lücken. 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 standardmäßig ausgefüllten Lücken. Es ist entweder "auto", "morePrecision", oder "lessPrecision". Der Standardwert ist "auto".
trailingZeroDisplay: Der für diese Eigenschaft im options-Argument angegebene Wert, mit standardmäßig ausgefüllten Lücken. Es ist entweder "auto" oder "stripIfInteger". Der Standardwert ist "auto".

Beispiele

Verwendung der Methode resolvedOptions()

Der folgende Code zeigt die Erstellung 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