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
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.
Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | 54 | No | 48 | No | No | 11 |
Feature | Android webview | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
Basic support | No | No | No | 56 | No | No | 11 |