setMessages
修改整个应用的默认错误文本。可以传入整个语言包,也可以只传入部分信息。
签名
ts
function setMessages(messages: Record<string, Message>): void参数
| 参数 | 类型 | 说明 |
|---|---|---|
messages | Record<string, Message> | 错误代码(required)或字段与代码(email.required、items.*.title.required)→ 文本或函数 (params) => string。其他信息保持不变 |
注意事项
- 全局生效 —— 在应用启动时调用一次即可。如需为单个请求设置语言,请使用
validate的messages选项。 - 直接传给规则的信息(
minLength(3, '...'))优先于全局信息。 - 完整的自定义语言文件:
npx tinyval lang ru—— 见 自定义语言文件。 - 可以为自定义错误代码添加信息 —— 见 自定义规则与 Schema。
- 错误代码列表见 错误信息与国际化。
示例
中文语言包
ts
import { setMessages } from 'tinyval';
import zh from 'tinyval/locales/zh';
setMessages(zh);部分文本
ts
setMessages({
required: '请填写此项',
minLength: (p) => `至少 ${p.min} 个字符`,
});另请参阅
- 错误信息与国际化:全部代码和参数