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
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 | 54 | 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 | 54.0 (54) (nightly-only) | No support | No support | No support |