Overview

Used in the context of aliasing locales (e.g. cn -> zh), the resolveCanonicalLocale method converts alias locale codes to their canonical BCP-47 locale codes when custom mapping is configured.

Reference

Parameters

Parameters Description

Returns

string - The canonical BCP-47 locale code if a mapping exists, otherwise the original locale code

Throws

• Error - If no locale is provided and the instance has no targetLocale configured

Examples

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

// Convert alias to canonical locale
const canonical = gt.resolveCanonicalLocale('cn');
console.log(canonical); // "zh"

// Regular BCP-47 codes pass through unchanged
const unchanged = gt.resolveCanonicalLocale('fr-FR');
console.log(unchanged); // "fr-FR"

Notes

• Converts alias locale codes to canonical BCP-47 locale codes
• Returns original locale if no custom mapping exists
• Works with the customMapping configuration from the GT constructor
• No validation is performed on the input or output locale codes

Next Steps

• Resolve back to aliases with resolveAliasLocale
• Validate locales with isValidLocale
• Standardize locale format with standardizeLocale