maxLength

字符串或数组的长度不超过 max。

签名

function maxLength(max: number, msg?: Message): Action<{ length: number }>

参数

参数	类型	说明
max	number	最大长度（包含）
msg	Message	自定义错误信息。可以是带 {参数} 的字符串或函数

错误代码

代码	触发条件	默认信息
maxLength	字符串长于 max	Must be at most {max} {max|character|characters} long
maxItems	数组元素多于 max	Must have at most {max} {max|item|items}

可以修改这些文本：见 错误信息与国际化。

注意事项

• 适用于字符串和数组。
• 字符串长度按 UTF-16 计算：emoji 和部分生僻字占 2 个单位（'😀'.length === 2）。

示例

符合数据库字段长度

pipe(string(), trim(), maxLength(255))

最多 5 个文件

pipe(array(string()), maxLength(5))

另请参阅

• minLength
• length