概要

isValidLocale メソッドは、ロケールコードが正しい形式で記述され、有効な BCP-47 のロケールとして認識されるかを検証します。 Intl API を用いてロケールの構造、言語の判別、地域・スクリプトの妥当性を確認し、カスタムのロケールマッピングにも対応します。

参考

パラメータ

パラメーターの説明

戻り値

boolean - locale が有効なら true、それ以外は false

送出される例外

• Error - locale が指定されておらず、かつインスタンスに targetLocale が構成されていない場合

例

const gt = new GT({
  sourceLocale: 'en',
  targetLocale: 'es'
});

const isValid = gt.isValidLocale('en-US');
console.log(isValid); // true

const isInvalid = gt.isValidLocale('invalid-locale');
console.log(isInvalid); // false

注意事項

• ブラウザの Intl APIs を使用して、BCP-47 ロケールの包括的な検証を行います
• カスタムマッピングの対応ロケールは常に true と判定されます（標準の検証をスキップ）
• 私用（private-use）の言語コード（qaa-qtz）をサポートします
• 形式不正または認識できないロケールコードの場合は false を返します

次のステップ

• getLocaleProperties でロケールのプロパティを取得する
• determineLocale で最適なロケールを判定する
• getLocaleName でロケールの名称を取得する
• CustomMapping 型について詳しく学ぶ