Intl.Locale.prototype.minimize()

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 méthode Intl.Locale.prototype.minimize() tente de retirer les informations qui auraient pu être ajoutée à une locale lors d'un appel à Locale.maximize().

Exemple interactif

const english = new Intl.Locale("en-Latn-US");
const korean = new Intl.Locale("ko-Kore-KR");
const arabic = new Intl.Locale("ar-Arab-EG");

console.log(english.minimize().baseName);
// Expected output: "en"

console.log(korean.minimize().baseName);
// Expected output: "ko"

console.log(arabic.minimize().baseName);
// Expected output: "ar"

Syntaxe

js
locale.minimize();

Valeur de retour

Une instance Locale dont la propriété baseName renvoie le résultat de l'exécution de l'algorithme de suppression des composantes probables sur locale.baseName.

Description

Cette méthode effectue l'opération inverse de maximize(), en retirant les fragments de langue/script ou de région qui sont superflus. Ainsi, "en-Latn" pourra être minimisé en "en" car l'anglais s'écrit uniquement à l'aide de l'alphabet latin.

minimize() ne modifie pas les éventuelles extensions décrites dans la chaîne de locale (après le "-u") ou via l'objet de configuration (elle ne modifie donc pas les valeurs de Locale.hourCycle, Locale.calendar et Locale.numeric).

Exemples

js
let maLocale = new Intl.Locale("fr-Latn-FR", {
  hourCycle: "h24",
  calendar: "gregory",
});
console.log(maLocale.baseName); // Affiche "fr-Latn-FR"
console.log(maLocale.toString()); // Affiche "fr-Latn-FR-u-ca-gregory-hc-h24"
let maLocMinimized = maLocale.minimize();

console.log(maLocMinimized.baseName);
// Affiche "fr" car le français est écrit uniquement avec l'alphabet latin et
// parlé le plus largement en France

console.log(maLocMinimized.toString());
// Affiche "fr-u-ca-gregory-hc-h24". On voit ici que les extensions
// (décrites après "-u") restent inchangées.

Spécifications

Specification
ECMAScript® 2026 Internationalization API Specification
# sec-Intl.Locale.prototype.minimize

Compatibilité des navigateurs

Voir aussi