概要

ロケールのエイリアス（例: cn -> zh）に関するコンテキストで使用される resolveCanonicalLocale メソッドは、カスタムマッピングが設定されている場合、エイリアスのロケールコードを正準的な BCP-47 ロケールコードに解決します。

リファレンス

パラメータ

パラメータの説明

返り値

string - マッピングがある場合は正規の BCP-47 ロケールコード、ない場合は元のロケールコード

例外

• Error - locale が指定されておらず、かつインスタンスに 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 のコンストラクタの customMapping 設定と連携して動作します
• 入力および出力のロケールコードに対する検証は行いません

次のステップ

• resolveAliasLocale でエイリアスに解決する
• isValidLocale で対応ロケールを検証する
• standardizeLocale で locale の形式を標準化する