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
JavaScript
Copy Code
Intl.getCanonicalLocales(locales)
Parameters
locales- A list of
Stringvalues for which to get the canonical locale names.
Return value
An array containing the canonical locale names.
Examples
JavaScript
Copy Code
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
Specifications
| Specification | Status | Comment |
|---|---|---|
| ECMAScript Internationalization API 4.0 (ECMA-402) The definition of 'Intl.getCanonicalLocales' in that specification. |
Draft | Initial definition. |
Browser compatibility
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| Basic support | No support | 48 (48) | No support | No support | No support |
| Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Basic support | No support | No support | No support | No support | No support | No support |
See also
Intl.NumberFormat.supportedLocalesOf()Intl.DateTimeFormat.supportedLocalesOf()Intl.Collator.supportedLocalesOf()
License
© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/javascript/reference/global_objects/intl/getcanonicallocales