Vue d’ensemble

Utilisée dans le contexte de l’aliasing des locales (p. ex. cn -> zh), la méthode resolveCanonicalLocale convertit les codes de locale alias en leurs codes de locale BCP-47 canoniques lorsqu’un mappage personnalisé est configuré.

Références

Paramètres

Description des paramètres

Renvoie

string - Le code de locale BCP-47 canonique s’il existe une correspondance, sinon le code de locale d’origine

Exceptions

• Error - Si aucune locale n’est fournie et que l’instance n’a pas de targetLocale configurée

Exemples

const gt = new GT({
  sourceLocale: 'en',
  customMapping: {
    'cn': { code: 'zh', name: 'Mandarin' },
  }
});

// Convertir l'alias en locale canonique
const canonical = gt.resolveCanonicalLocale('cn');
console.log(canonical); // "zh"

// Les codes BCP-47 standards restent inchangés
const unchanged = gt.resolveCanonicalLocale('fr-FR');
console.log(unchanged); // "fr-FR"

Notes

• Convertit les codes de locale alias en codes de locale BCP-47 canoniques
• Renvoie la locale d’origine si aucun mappage personnalisé n’est défini
• Fonctionne avec la configuration customMapping du constructeur GT
• Aucune validation n’est effectuée sur les codes de locale en entrée ou en sortie

Prochaines étapes

• Résoudre vers les alias avec resolveAliasLocale
• Valider les locales avec isValidLocale
• Standardiser le format des locales avec standardizeLocale