Intl : méthode statique getCanonicalLocales()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis octobre 2017.
La méthode statique getCanonicalLocales() des instances de Intl retourne un tableau contenant les noms canoniques des locales. Les doublons sont omis et les éléments sont validés comme des balises de langue structurellement valides.
Exemple interactif
console.log(Intl.getCanonicalLocales("EN-US"));
// Résultat attendu : Array ["en-US"]
console.log(Intl.getCanonicalLocales(["EN-US", "Fr"]));
// Résultat attendu : Array ["en-US", "fr"]
try {
Intl.getCanonicalLocales("EN_US");
} catch (err) {
console.log(err.toString());
// Résultat attendu (Firefox/Safari) : RangeError: invalid language tag: "EN_US"
// Résultat attendu (Chrome) : RangeError: Incorrect locale information provided
}
Syntaxe
js
Intl.getCanonicalLocales(locales)
Paramètres
Valeur de retour
Un tableau qui contient les noms canoniques des locales.
Exemples
Utiliser la méthode getCanonicalLocales()
js
Intl.getCanonicalLocales("EN-US"); // ["en-US"]
Intl.getCanonicalLocales(["EN-US", "Fr"]); // ["en-US", "fr"]
Intl.getCanonicalLocales("EN_US");
// RangeError: invalid language tag: "EN_US"
Spécifications
| Specification |
|---|
| ECMAScript® 2026 Internationalization API Specification # sec-intl.getcanonicallocales |