JavaScript | Método Intl.getCanonicalLocales()

El método Intl.getCanonicalLocales() en JavaScript es un objeto integrado estándar que devuelve una array que contiene los nombres de las configuraciones regionales canónicas. 
Sintaxis: 
 

Intl.getCanonicalLocales(locales)

Parámetros: este método acepta un solo parámetro como se mencionó anteriormente y se describe a continuación: 
 

• locales: este parámetro contiene una lista de valores de string para los que obtener los nombres canónicos de configuración regional.

Valor devuelto: este método devuelve una array que contiene los nombres canónicos de configuración regional.
Los siguientes ejemplos ilustran el método Intl.getCanonicalLocales() en JavaScript:
Ejemplo 1: 
 

console.log(Intl.getCanonicalLocales('EN-US'));
console.log(Intl.getCanonicalLocales(['EN-US', 'Fr']));
 
try {
    Intl.getCanonicalLocales('GeeksforGeeks');
} catch (error) {
    console.log(error);
}

Producción: 
 

Array ["en-US"]
Array ["en-US", "fr"]
RangeError: Incorrect locale information provided

Ejemplo 2: 
 

console.log(Intl.getCanonicalLocales('EN-US'));
console.log(Intl.getCanonicalLocales(['EN-US', 'Fr']));
 
try {
    console.log(Intl.getCanonicalLocales(['Tr', 'UT']));
} catch (error) {
    console.log(error);
}

Producción: 
 

Array ["en-US"]
Array ["en-US", "fr"]
Array ["tr", "ut"]

Navegadores compatibles: los navegadores compatibles con el método Intl.getCanonicalLocales() se enumeran a continuación: 
 

• Google Chrome 54 y superior
• Firefox 48 y superior
• Safari 11 y superior
• Borde 16 y superior