Vue d’ensemble

La méthode standardizeLocale normalise un code de locale BCP-47 afin de garantir un formatage et une casse corrects. Elle convertit les codes de locale dans leur format canonique, les rendant adaptés à une utilisation avec les API d’internationalisation et assurant la cohérence dans l’ensemble de votre application.

Références

Paramètres

Description des paramètres

Renvoie

string - Le code de locale BCP‑47 standardisé, ou une chaîne vide si l’entrée est invalide

Exceptions

• Error - Si aucune locale n’est fournie et qu’aucune targetLocale n’est configurée pour l’instance

Comportement

Corrections de format courantes appliquées :

• en_US → en-US (trait de soulignement remplacé par un tiret)
• zh_cn → zh-CN (trait de soulignement remplacé par un tiret, casse)
• EN-gb → en-GB (langue en minuscules, région en majuscules)
• Fr-ca → fr-CA (casse correcte partout)
• ja_jp → ja-JP (trait de soulignement et casse)

Exemples

const gt = new GT({
  sourceLocale: 'en',
  targetLocale: 'es-ES'
});

// Normalise différents formats de locale
console.log(gt.standardizeLocale('en_us')); // "en-US"
console.log(gt.standardizeLocale('zh_cn')); // "zh-CN"
console.log(gt.standardizeLocale('EN-gb')); // "en-GB"
console.log(gt.standardizeLocale('fr-ca')); // "fr-CA"

// Les locales déjà normalisées restent inchangées
console.log(gt.standardizeLocale('es-ES')); // "es-ES"
console.log(gt.standardizeLocale('ja-JP')); // "ja-JP"

Notes

• Convertit les underscores en tirets et normalise la casse
• Renvoie une chaîne vide pour les codes de locale non valides
• Les codes de langue sont mis en minuscules, les codes de région en majuscules
• Préserve les extensions et variantes de locale lorsqu’elles sont présentes

Prochaines étapes

• Valider les locales normalisées avec isValidLocale
• Résoudre les locales canoniques avec resolveCanonicalLocale
• Obtenir les propriétés de locale avec getLocaleProperties