Intl.DisplayNames.prototype.resolvedOptions()

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

Syntax

displayNames.resolvedOptions()

Return value

An object with properties reflecting the locale and formatting options computed during the construction of the given DisplayNames 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 ("language"). Its value is either "language", "region", "script", or "currency".
fallback
The value provided for this property in the options argument of the constructor or the default value ("code"). Its value is either "code" or "none".

Examples

Using resolvedOptions

const displayNames = new Intl.DisplayNames(['de-DE'], {type: 'region'});

const usedOptions = displayNames.resolvedOptions();
console.log(usedOptions.locale);   // "de-DE"
console.log(usedOptions.style);    // "long"
console.log(usedOptions.type);     // "region"
console.log(usedOptions.fallback); // "code"

Specifications

Specification
Intl.DisplayNames
The definition of 'resolvedOptions()' in that specification.

Browser compatibility

DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung InternetNode.js
resolvedOptionsChrome Full support 81Edge Full support 81Firefox No support NoIE No support NoOpera Full support 68Safari No support NoWebView Android Full support 81Chrome Android Full support 81Firefox Android No support NoOpera Android Full support 58Safari iOS No support NoSamsung Internet Android No support Nonodejs Full support 14.0.0

Legend

Full support
Full support
No support
No support

See also