Intl​.List​Format​.prototype​.resolvedOptions()

Draft
This page is not complete.

The Intl.ListFormat.prototype.resolvedOptions() method returns a new object with properties reflecting the locale and style formatting options computed during the construction of the current ListFormat object.

Syntax

listFormat.resolvedOptions()

Return value

An object with properties reflecting the locale and formatting options computed during the construction of the given ListFormat object.

Description

The object returned by resolvedOptions() has the following properties:

locale
The BCP 47 language tag for the locale actually used. If any Unicode extension values were requested in the input BCP 47 language tag that led to this locale, the key-value pairs that were requested and are supported for this locale are included in locale.
style
The value provided for this property in the options argument of the constructor or the default value ( "long"). Its value is either "long", "short", or "narrow".
type
The value provided for this property in the options argument of the constructor or the default value ( "conjunction"). Its value is either "conjunction", "disjunction", or "unit".

Examples

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)

Specifications

Specification Status Comment
Intl.ListFormat.prototype.resolvedOptions() proposal Stage 3

Browser compatibility

Update compatibility data on GitHub
Desktop Mobile Server
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet Node.js
resolvedOptions
Experimental
Chrome Full support 72 Edge No support No Firefox No support No IE No support No Opera Full support 60 Safari No support No WebView Android Full support 72 Chrome Android Full support 72 Firefox Android No support No Opera Android ? Safari iOS No support No Samsung Internet Android No support No nodejs No support No

Legend

Full support  
Full support
No support  
No support
Compatibility unknown  
Compatibility unknown
Experimental. Expect behavior to change in the future.
Experimental. Expect behavior to change in the future.

See also