Panoramica

Nel contesto dell’aliasing delle lingue/locali (ad es. cn -> zh), il metodo resolveCanonicalLocale converte i codici di locale alias nei rispettivi codici di locale canonici BCP‑47 quando è configurata una mappatura personalizzata.

Riferimento

Parametri

Descrizione dei parametri

Restituisce

string - Il codice locale canonico BCP‑47 se è disponibile una corrispondenza, altrimenti il codice locale originale

Eccezioni generate

• Error - Se non viene specificata una locale e l'istanza non ha un targetLocale configurato

Esempi

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

// Converti l'alias in locale canonico
const canonical = gt.resolveCanonicalLocale('cn');
console.log(canonical); // "zh"

// I codici BCP-47 standard rimangono invariati
const unchanged = gt.resolveCanonicalLocale('fr-FR');
console.log(unchanged); // "fr-FR"

Note

• Converte i codici locale alias nei corrispondenti codici locale BCP‑47 canonici
• Restituisce il locale originale se non è presente alcuna mappatura personalizzata
• Funziona con la configurazione customMapping del costruttore di GT
• Non viene eseguita alcuna validazione sui codici locale in input o in output

Prossimi passaggi

• Risolvi gli alias con resolveAliasLocale
• Convalida le locale con isValidLocale
• Uniforma il formato della locale con standardizeLocale