Intl.Locale.prototype.region

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2020.

La propriété Intl.Locale.prototype.region est fournie par un accesseur qui renvoie la région du monde (il s'agit généralement d'un pays) associée à la locale courante.

Description

La région est un fragment majeur de l'identifiant de la locale car il situe la locale dans une zone donnée du monde. Connaître la région associée à la locale est crucial pour identifier les différences entre les locales. Ainsi, on parle anglais aux États-Unis et au Royaume-Uni mais il existe certaines différences d'orthographe entre ces pays. Connaître la région d'une locale peut permettre aux développeurs d'adapter leurs sites et applications selon la région depuis laquelle ils sont consultés.

Exemples

Définir la région avec la chaîne de caractères décrivant la locale

La région est la troisième composante d'une chaîne représentant un identifiant de langue Unicode. Cette chaîne de caractères est généralement passée au constructeur Locale.

js
let regionStr = new Intl.Locale("en-Latn-US");

console.log(regionStr.region);
// Affichera "US" dans la console

Définir la région via l'objet de configuration du constructeur

Le constructeur Locale prend comme second argument un objet de paramétrage dont chacune des propriétés permet de définir une extension ou une composante de la locale.

js
let regionObj = new Intl.Locale("fr-Latn", { region: "FR" });

console.log(regionObj.region);
// Affichera "FR" dans la console

Spécifications

Specification
ECMAScript Internationalization API Specification
# sec-Intl.Locale.prototype.region

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi