Overview

The resolveAliasLocale method maps a canonical locale code back to its original alias locale code when custom mapping is configured. This is the inverse of resolveCanonicalLocale.

Reference

Parameters

Parameter descriptions

Returns

string - The alias locale code if a mapping exists; otherwise, the original locale code

Throws

• Error — if no locale is provided and no target locale is configured

Examples

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

// Resolve canonical locale back to alias
const alias = gt.resolveAliasLocale('zh');
console.log(alias); // "cn"

// Non-mapped locale returns the original
const unchanged = gt.resolveAliasLocale('es');
console.log(unchanged); // "es"

Notes

• Returns the original alias locale code when a custom mapping exists
• Returns the input locale unchanged if no mapping is found

Next steps

• Resolve canonical locales with resolveCanonicalLocale
• Validate locales with isValidLocale
• Get locale properties with getLocaleProperties