Utility FunctionsLocales
isValidLocale
isValidLocale 函数的 API 参考
概述
isValidLocale 函数用于校验给定字符串是否为有效的 BCP-47 语言代码。它无需 GT class 实例即可完成全面的格式验证。
参考资料
参数
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 格式
本指南如何?