自动化测试 / 系统课时

上传文件

上传文件

文件上传测试不能像文本框那样填写本地路径,而应把文件直接设置到 input[type='file']。本节用 setInputFiles() 完成单文件、多文件和清空操作,并通过浏览器中的 FileList 验证选择结果,最后区分“已选文件”和“服务器上传成功”。

学习目标

  • 使用 setInputFiles() 设置单个文件和多个文件
  • 验证文件名、文件数量,并清空已选择文件
  • 判断何时需要继续验证上传请求或页面结果

直接设置文件输入

Playwright 的 locator.setInputFiles() 面向文件输入控件工作。参数既可以是本地文件路径,也可以是内存中的文件对象;传入数组可以设置多个文件,传入空数组 [] 可以清空选择。

测试夹具文件较多时可以使用路径;如果只想验证上传交互,内存文件更轻量,不需要提前在仓库创建真实文件。对于相对路径,要记住它是相对于测试进程当前工作目录解析的,因此团队项目里更适合使用稳定的绝对路径或统一的 fixture 目录。

设置单文件和多文件

下面的示例创建两个文件输入:一个只允许单文件,另一个带 multiple 属性。文件内容直接放在内存中,因此示例无需额外准备测试文件。

ts
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}`);
});

预期输出(忽略测试运行器自身日志):

text
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'),再触发按钮,并通过得到的文件选择器设置文件。关键是先等待事件、后点击,避免文件选择事件在监听建立前已经发生。

把“选择文件”“发起上传”“服务器确认”分成三个可验证阶段,能够让失败信息更准确:前两步正常而最终结果失败时,问题通常已不在文件输入本身,而在请求、校验或后端处理链路。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

上传文件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通