概述

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 始终校验为 true（跳过标准校验）
• 支持私用语言代码（qaa-qtz）
• 对格式错误或无法识别的语言代码返回 false

后续步骤

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