文件上传步骤

CueCast 将“你在录制时正常完成页面上传”和“回放时使用可管理的测试文件”分开处理。

• 录制时，目标页面照常打开系统文件选择器并完成自己的上传流程。
• 用户实际选中文件后，CueCast 记录一条上传步骤，但不会上传或保存你本机刚选择的文件内容。
• 保存用例后，需要在该步骤中绑定一份 CueCast 测试文件；回放时才会把这份绑定文件注入页面控件。

这样既不会打断真实录制流程，也能让后续回放使用团队可管理、可重复的测试文件。

录制文件上传

1. 从用例详情开始录制。
2. 在目标页面按正常方式点击上传按钮、标签或文件输入框。
3. 在系统文件选择器中选择文件，并让目标页面完成其正常的上传交互。
4. 停止录制并保存步骤。

只有实际发生文件选择并触发控件 change 后，CueCast 才会生成 upload_file 步骤。取消系统文件选择不会生成空步骤。

适用的常见页面形态：

• 可见的原生 <input type="file">；
• 使用 <label> 触发的文件输入框；
• 上传按钮代理一个隐藏 file input 的组件库上传控件。

为步骤绑定回放文件

录制完成后，在用例详情中编辑该上传步骤：

1. 上传一份用于自动化回放的测试文件，或从当前用例已上传的测试文件中选择。
2. 保存步骤。
3. 单条回放验证页面是否收到文件并进入预期业务流程。

测试文件按组织隔离，并且只有所属用例的绑定步骤可以在回放时读取。单个文件最大 10 MB。

回放时会发生什么

回放遇到已绑定的上传步骤时，CueCast 直接把绑定文件写入目标 file input，并触发页面通常依赖的 input / change 事件。

对于“点击按钮后才会露出隐藏 input”的控件，回放会避免打开系统文件选择窗口，但仍保留页面按钮本身的业务逻辑。这样页面用于显示上传区域、初始化校验或切换状态的代码仍可执行。

当前边界

• 一个上传步骤当前绑定一个文件；多文件上传尚未支持。
• 拖拽上传尚未支持。
• 系统文件选择窗口只在录制阶段由用户正常操作；回放不会尝试自动操作系统窗口。
• 页面可能还会进行格式、大小、权限、病毒扫描或后端业务校验。这些是目标系统行为，CueCast 只负责把绑定文件交给页面控件。

常见问题

现象	优先检查
录制后没有上传步骤	是否实际选择了文件并让页面触发 change；取消选择不会生成步骤。
回放提示未绑定文件	打开该上传步骤，上传或选择一份测试文件后保存。
回放页面没有收到文件	检查步骤定位是否仍命中真实 file input；再确认页面是否依赖额外点击或异步初始化。
页面返回格式或大小错误	更换符合目标系统规则的测试文件；CueCast 不绕过页面业务校验。
上传文件无法保存	检查单文件是否超过 10 MB，以及 OSS/网络服务是否可用。

如果上传步骤失败，请结合 结果与排障 中的失败截图、错误信息和证据面板判断：是控件定位问题、文件绑定问题，还是目标系统自身的校验失败。