Web/JavaScript/Reference/Global objects/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.

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

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 (ECMA-402)The definition of 'Intl.getCanonicalLocales' in that specification.

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
`getCanonicalLocales`	Chrome Full support 54	Edge Full support 16	Firefox Full support 48	IE No support No	Opera No support No	Safari Full support 11	WebView Android No support No	Chrome Android No support No	Firefox Android Full support 56	Opera Android No support No	Safari iOS Full support 11	Samsung Internet Android No support No	nodejs Full support 7.0.0

Legend

Full support: Full support
No support: No support