Descripción general

En el contexto de alias de locales (p. ej., cn -> zh), el método resolveCanonicalLocale convierte los códigos de configuración regional alias en sus códigos BCP-47 canónicos cuando se ha configurado un mapeo personalizado.

Referencias

Parámetros

Descripción de parámetros

Devuelve

string - El código de configuración regional BCP-47 canónico si existe un mapeo; de lo contrario, el código de configuración regional original

Lanza

• Error - Si no se proporciona un locale y la instancia no tiene targetLocale configurado

Ejemplos

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

// Convertir un alias al locale canónico
const canonical = gt.resolveCanonicalLocale('cn');
console.log(canonical); // "zh"

// Los códigos BCP-47 estándar pasan sin cambios
const unchanged = gt.resolveCanonicalLocale('fr-FR');
console.log(unchanged); // "fr-FR"

Notas

• Convierte alias de códigos de configuración regional en códigos BCP-47 canónicos
• Devuelve el locale original si no existe un mapeo personalizado
• Funciona con la configuración customMapping del constructor de GT
• No se realiza ninguna validación en los códigos de configuración regional de entrada o salida

Próximos pasos

• Resolver alias con resolveAliasLocale
• Validar locales con isValidLocale
• Estandarizar el formato del locale con standardizeLocale