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
Polyfill
Specifications
| Specification |
|---|
| ECMAScript Internationalization API Specification (ECMAScript Internationalization API) # sec-intl.getcanonicallocales |
Browser compatibility
BCD tables only load in the browser