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
Specifications
Specification |
---|
ECMAScript Internationalization API (ECMA-402) The definition of 'Intl.getCanonicalLocales' in that specification. |
Browser compatibility
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.
Desktop | Mobile | Server | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
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