概览

isValidLocale 方法用于验证语言代码的格式是否正确，并确认其是否为有效的 BCP-47 locale。 它借助 Intl API 检查 locale 结构、语言识别，以及区域/脚本的有效性，并支持自定义 locale 映射。

参考资料

参数

参数说明

返回值

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 locale 验证
• 自定义映射的 locales 始终视为通过（跳过标准验证）
• 支持私有用途语言代码（qaa–qtz）
• 对格式错误或无法识别的语言代码返回 false

下一步

• 使用 getLocaleProperties 获取 locale 属性
• 使用 determineLocale 判定最佳 locale
• 使用 getLocaleName 获取 locale 名称
• 了解 CustomMapping 类型