Proxy 实现的数据验证核心是结构化规则与自动化校验:通过声明式 schema 定义字段类型、约束及提示,set 拦截中执行类型转换、多级检查、错误收集与状态同步,并支持嵌套、数组、动态扩展及可交互接口。

用 Proxy 实现复杂的数据验证逻辑,关键不是堆砌判断,而是把规则结构化、校验流程自动化、错误反馈可感知。它不依赖运行时手动调用校验函数,而是在赋值那一刻就完成类型转换、多条件检查、错误收集和状态同步。
设计可配置的验证 schema
把字段约束写成声明式配置,而不是散落在 set 里的 if 判断。每个字段对应一个对象,明确标注类型、是否必填、范围、正则、自定义校验函数和提示语:
- type:支持 'string'、'number'、'email'、'boolean',自动做基础类型转换(如 '25' → 25)
- required:true 时,空字符串、null、undefined 都算不合法
- min/max/length/pattern:按需启用,比如 age: { type: 'number', min: 0, max: 150 }
- validate:接受 (value, data) => boolean | string,返回 false 或错误消息,支持跨字段校验(如 password 和 confirmPwd 一致性)
- message:失败时的友好提示,便于绑定到表单 UI
在 set 拦截中执行完整校验链
每次赋值都走一遍标准化流程,而不是只做单一检查:
⚠️ 已弃用 — 该技能已拆分为两个独立技能,以提升模块化程度:**webchat-https-proxy**(HTTPS/WSS 反向代理)和 **webchat-voi...**
- 先查 schema 是否定义该字段;未定义则跳过验证,保持向后兼容
- 尝试类型转换(如 Number(value)、value?.trim()),再拿转换后的值参与后续校验
- 依次执行:必填检查 → 类型匹配 → 范围/长度/正则 → 自定义 validate 函数
- 任一环节失败,记录错误到内部 errors 对象,不写入 target;全部通过才调用 Reflect.set
- 触发字段级或全局 isValid 状态更新,支持响应式联动
暴露可交互的验证接口
验证器不能只“拦”,还要让业务能读、能问、能清:
- errors:getter,返回 { email: '邮箱格式错误', age: '年龄必须在 0–150 之间' },UI 可直接 v-model 绑定
- isValid():遍历所有字段 errors,返回布尔值,适合提交前兜底判断
- validate(field?):手动重验——传字段名只验单个(如失焦时),不传则全量重跑(如提交前)
- reset():清空所有值与 errors,复用表单实例时无需重建代理
支持嵌套与动态扩展
真实业务常有嵌套结构(如 address.city)、数组项校验(users[0].name)、或运行时新增字段:
- 对点号路径('profile.email')做解析,递归代理嵌套对象,校验时能定位到深层字段
- 数组字段可配合 itemSchema 单独定义每项规则,例如 users: { type: 'array', itemSchema: { name: { required: true } } }
- 新增字段只需往 schema 里加配置,无需改 Proxy handler 或业务赋值代码

















