Intl.ListFormat.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 April 2021.

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

Probieren Sie es aus

const deListFormatter = new Intl.ListFormat("de-DE", { type: "disjunction" });
const options = deListFormatter.resolvedOptions();

console.log(options.locale);
// Expected output: "de-DE"

console.log(options.style);
// Expected output: "long"

console.log(options.type);
// Expected output: "disjunction"

Syntax

js
resolvedOptions()

Parameter

Keine.

Rückgabewert

Ein neues Objekt mit Eigenschaften, die die während der Initialisierung dieses ListFormat-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 die tatsächlich verwendete Locale, bestimmt durch den Locale-Aushandlungsprozess. Kein Unicode-Erweiterungsschlüssel wird in der Ausgabe enthalten sein.

type

Der Wert, der für diese Eigenschaft im options-Argument bereitgestellt wurde, wobei die Standards nach Bedarf ausgefüllt werden. Er ist entweder "conjunction", "disjunction" oder "unit". Der Standard ist "conjunction".

style

Der Wert, der für diese Eigenschaft im options-Argument bereitgestellt wurde, wobei die Standards nach Bedarf ausgefüllt werden. Er ist entweder "long", "short" oder "narrow". Der Standard ist "long".

Beispiele

Verwendung von resolvedOptions

js
const deListFormatter = new Intl.ListFormat("de-DE", { style: "short" });

const usedOptions = de.resolvedOptions();
console.log(usedOptions.locale); // "de-DE"
console.log(usedOptions.style); // "short"
console.log(usedOptions.type); // "conjunction" (the default value)

Spezifikationen

Specification
ECMAScript® 2026 Internationalization API Specification
# sec-Intl.ListFormat.prototype.resolvedoptions

Browser-Kompatibilität

Siehe auch