Utility FunctionsLocales
isValidLocale
isValidLocale 函数的 API 参考
概览
isValidLocale 函数用于验证给定字符串是否为有效的 BCP-47 语言代码(locale code)。它无需 GT 类实例即可进行全面的格式校验。
参考资料
参数
Prop
Type
返回值
boolean - 若语言代码有效,则为 true;否则为 false
示例
import { isValidLocale } from 'generaltranslation';
// 有效的语言代码
console.log(isValidLocale('en-US')); // true
console.log(isValidLocale('zh-CN')); // true
console.log(isValidLocale('es')); // true
// 无效的语言代码
console.log(isValidLocale('invalid')); // false
console.log(isValidLocale('en_US')); // false(使用下划线而不是连字符)
console.log(isValidLocale('')); // false说明
- 验证 BCP-47 语言代码格式
- 支持自定义 locale 映射
- 对用户输入验证至关重要
- 无需网络请求——纯格式验证
- 无状态函数,适合工具库使用
后续步骤
- 使用 GT class 方法 isValidLocale
- 通过 standardizeLocale统一 locale 格式
这份指南怎么样?

