Utility FunctionsLocales
standardizeLocale
standardizeLocale 函数的 API 参考
概览
standardizeLocale 函数会将 BCP-47 语言代码标准化,以确保格式和大小写正确,无需依赖 GT 类实例。
import { standardizeLocale } from 'generaltranslation';
// 修复常见格式问题
console.log(standardizeLocale('en_us')); // 'en-US'
console.log(standardizeLocale('zh_cn')); // 'zh-CN'
console.log(standardizeLocale('EN-gb')); // 'en-GB'
console.log(standardizeLocale('fr-ca')); // 'fr-CA'
// 已标准化的 locale 直接通过
console.log(standardizeLocale('es-ES')); // 'es-ES'参考资料
参数
Prop
Type
返回值
string - 标准化的 BCP-47 语言代码;如果无效则返回空字符串
示例
用户输入处理
import { standardizeLocale, isValidLocale } from 'generaltranslation';
function processUserInput(input: string) {
  const standardized = standardizeLocale(input.trim());
  const isValid = isValidLocale(standardized);
  
  return {
    original: input,
    standardized,
    isValid
  };
}
// 测试各种输入
const inputs = ['en_us', 'FR-ca', 'invalid', 'zh-CN'];
inputs.forEach(input => {
  console.log(processUserInput(input));
});说明
- 将下划线转换为连字符
- 规范化大小写(语言小写,地区大写)
- 对无效格式返回空字符串
- 用于规范化来自各类来源的 locale 输入
- 无外部依赖——纯字符串处理
后续步骤
- 使用 GT class 方法 standardizeLocale
- 通过 isValidLocale验证
这份指南怎么样?

