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
Stringvalues 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
Specifications
| Specification |
|---|
| ECMAScript Internationalization API Specification # sec-intl.getcanonicallocales |
Browser compatibility
Report problems with this compatibility data on GitHub| desktop | mobile | server | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
getCanonicalLocales | ChromeFull support54 | EdgeFull support16 | FirefoxFull support48 | Internet ExplorerNo supportNo | OperaNo supportNo | SafariFull support11 | WebView AndroidNo supportNo | Chrome AndroidNo supportNo | Firefox for AndroidFull support56 | Opera AndroidNo supportNo | Safari on iOSFull support11 | Samsung InternetNo supportNo | DenoFull support1.8 | Node.jsFull support7.0.0 |
Legend
- Full support
- Full support
- No support
- No support
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.