Обзор

В контексте алиасов локалей (например, cn → zh) метод resolveCanonicalLocale преобразует коды алиасов в их канонические коды локалей по BCP‑47, если задано пользовательское отображение.

Справка

Параметры

Описание параметров

Возвращает

string — канонический код локали по BCP‑47, если существует соответствие; в противном случае — исходный код локали

Исключения

• Error — если локаль не указана и у экземпляра не задан targetLocale

Примеры

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

// Преобразовать псевдоним в каноническую локаль
const canonical = gt.resolveCanonicalLocale('cn');
console.log(canonical); // "zh"

// Обычные коды BCP-47 проходят без изменений
const unchanged = gt.resolveCanonicalLocale('fr-FR');
console.log(unchanged); // "fr-FR"

Примечания

• Преобразует альтернативные коды локалей в канонические коды по стандарту BCP‑47
• Возвращает исходную локаль, если нет пользовательского сопоставления
• Работает с параметром customMapping конструктора GT
• Входные и выходные коды локалей не валидируются

Дальше

• Сопоставляйте обратно к псевдонимам с помощью resolveAliasLocale
• Проверяйте локали с помощью isValidLocale
• Приводите формат локали к стандарту с помощью standardizeLocale