Skip to content

setMessages ​

修改整个应用的默认错误文本。可以传入整个语言包,也可以只传入部分信息。

签名 ​

ts
function setMessages(messages: Record<string, Message>): void

参数 ​

参数类型说明
messagesRecord<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} 个字符`,
});

另请参阅 ​