自动化测试 / 系统课时
上传文件
上传文件
文件上传测试不能像文本框那样填写本地路径,而应把文件直接设置到 input[type='file']。本节用 setInputFiles() 完成单文件、多文件和清空操作,并通过浏览器中的 FileList 验证选择结果,最后区分“已选文件”和“服务器上传成功”。
学习目标
- 使用
setInputFiles()设置单个文件和多个文件 - 验证文件名、文件数量,并清空已选择文件
- 判断何时需要继续验证上传请求或页面结果
直接设置文件输入
Playwright 的 locator.setInputFiles() 面向文件输入控件工作。参数既可以是本地文件路径,也可以是内存中的文件对象;传入数组可以设置多个文件,传入空数组 [] 可以清空选择。
测试夹具文件较多时可以使用路径;如果只想验证上传交互,内存文件更轻量,不需要提前在仓库创建真实文件。对于相对路径,要记住它是相对于测试进程当前工作目录解析的,因此团队项目里更适合使用稳定的绝对路径或统一的 fixture 目录。
设置单文件和多文件
下面的示例创建两个文件输入:一个只允许单文件,另一个带 multiple 属性。文件内容直接放在内存中,因此示例无需额外准备测试文件。
import { test, expect } from '@playwright/test';
test('设置并验证上传文件', async ({ page }) => {
await page.setContent(`
<label>头像 <input type='file' id='avatar'></label>
<label>附件 <input type='file' id='attachments' multiple></label>
`);
const avatar = page.getByLabel('头像');
await avatar.setInputFiles({
name: 'avatar.txt',
mimeType: 'text/plain',
buffer: Buffer.from('avatar-content'),
});
const avatarName = await avatar.evaluate(
input => (input as HTMLInputElement).files?.[0]?.name ?? ''
);
expect(avatarName).toBe('avatar.txt');
const attachments = page.getByLabel('附件');
await attachments.setInputFiles([
{ name: 'a.txt', mimeType: 'text/plain', buffer: Buffer.from('A') },
{ name: 'b.txt', mimeType: 'text/plain', buffer: Buffer.from('B') },
]);
// FileList 的顺序应与设置文件时的顺序一致。
const names = await attachments.evaluate(
input =>
Array.from((input as HTMLInputElement).files ?? []).map(file => file.name)
);
expect(names).toEqual(['a.txt', 'b.txt']);
await attachments.setInputFiles([]);
const count = await attachments.evaluate(
input => (input as HTMLInputElement).files?.length ?? 0
);
expect(count).toBe(0);
console.log(avatarName);
console.log(names.join(','));
console.log(`afterClear=${count}`);
});预期输出(忽略测试运行器自身日志):
avatar.txt
a.txt,b.txt
afterClear=0这里验证的是浏览器文件输入中的选择结果:单文件输入得到 avatar.txt,多文件输入包含两个文件,清空后数量为 0。如果把多个文件传给不支持 multiple 的输入,测试不应假设浏览器会自动替你处理,而应先确认页面本身允许多选。
路径文件与内存文件怎么选
真实上传流程经常需要验证文件扩展名、大小或内容,这时可以让 setInputFiles() 指向准备好的 fixture,例如 <PATH>/fixtures/avatar.png。只测试“选择文件后页面如何响应”时,内存文件能减少磁盘依赖,并且文件名、MIME 类型和内容都能在测试中明确声明。
无论采用哪种方式,都不要用 fill() 给文件输入写一个字符串路径。浏览器对本地文件选择有专门的安全模型,Playwright 通过文件输入 API 注入文件,而不是模拟在文本框里键入路径。
验证真正的上传结果
setInputFiles() 成功只说明文件已经进入浏览器的 FileList,不等于后端已经接收并保存文件。如果页面在选择后立即发起请求,应继续等待对应网络响应或验证成功提示;如果必须点击“上传”按钮,则应点击后再检查响应状态和页面结果。
还有一种页面会在点击按钮后才动态创建文件输入。此时应在点击前先准备 page.waitForEvent('filechooser'),再触发按钮,并通过得到的文件选择器设置文件。关键是先等待事件、后点击,避免文件选择事件在监听建立前已经发生。
把“选择文件”“发起上传”“服务器确认”分成三个可验证阶段,能够让失败信息更准确:前两步正常而最终结果失败时,问题通常已不在文件输入本身,而在请求、校验或后端处理链路。