Intl.getCanonicalLocales()

The Intl.getCanonicalLocales() method returns an array containing the canonical locale names. Duplicates will be omitted and elements will be validated as structurally valid language tags.

Syntax

Intl.getCanonicalLocales(locales)

Parameters

locales: A list of String values for which to get the canonical locale names.

Return value

An array containing the canonical locale names.

Examples

Using getCanonicalLocales

Intl.getCanonicalLocales('EN-US'); // ["en-US"]
Intl.getCanonicalLocales(['EN-US', 'Fr']); // ["en-US", "fr"]

Intl.getCanonicalLocales('EN_US');
// RangeError:'EN_US' is not a structurally valid language tag

Polyfill

formatjs Intl.getCanonicalLocales polyfill

Specifications

Specification
ECMAScript Internationalization API Specification (ECMAScript Internationalization API) # sec-intl.getcanonicallocales

Browser compatibility

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet
`getCanonicalLocales`	54	16	48	No	No	11	No	No	56	No	11	No