Intl.DisplayNames() constructor

The Intl.DisplayNames() constructor creates Intl.DisplayNames objects that enable the consistent translation of language, region and script display names.

new Intl.DisplayNames([locales[, options]])

locales Optional

A string with a BCP 47 language tag, or an array of such strings. For the general form and interpretation of the locales argument, see the Intl page. The following Unicode extension key is allowed:

nu

The numbering system to be used. Possible values include: "arab", "arabext", "bali", "beng", "deva", "fullwide", "gujr", "guru", "hanidec", "khmr", "knda", "laoo", "latn", "limb", "mlym", "mong", "mymr", "orya", "tamldec", "telu", "thai", "tibt".

options Optional

An object with some or all of the following properties:

localeMatcher

The locale matching algorithm to use. Possible values are "lookup" and "best fit"; the default is "best fit". For information about this option, see the Intl page.

style

The formatting style to use, the default is "long".

• "narrow"
• "short"
• "long"

type

The type to use.

• "language"
• "region"
• "script"
• "currency"

fallback

The fallback to use, the default is "code".

• "code"
• "none"

In basic use without specifying a locale, a formatted string in the default locale and with default options is returned.

console.log((new Intl.DisplayNames([], {type: 'language'})).of('US'));
// Expected output: 'us'

• Intl.DisplayNames
• Intl