Playwright 文件操作-育师

Playwright 文件操作（2025 年最新版）

Playwright 本身是浏览器自动化工具，主要在浏览器环境中运行，但它提供了便捷的 API 来处理文件上传和文件下载。此外，在 Node.js 环境中，你可以结合 Node.js 的fs模块实现更复杂的本地文件读写操作。下面详细讲解常见文件操作场景。

1.文件上传（File Upload）

最常见的两种上传方式：

方式一：直接设置 input[type=“file”]（推荐，最稳定）

// tests/upload.spec.tsimport{test,expect}from'@playwright/test';importpathfrom'path';test('单个文件上传',async({page})=>{awaitpage.goto('https://example.com/upload');// 准备本地文件路径（相对项目根目录）constfilePath=path.join(__dirname,'../files/avatar.jpg');// 设置文件（自动触发 change 事件）awaitpage.getByLabel('上传头像').setInputFiles(filePath);// 验证上传成功awaitexpect(page.getByText('上传成功')).toBeVisible();});

方式二：上传多个文件

awaitpage.getByLabel('批量上传').setInputFiles([path.join(__dirname,'../files/file1.pdf'),path.join(__dirname,'../files/file2.png'),]);

方式三：清空已选择的文件

awaitpage.getByLabel('上传文件').setInputFiles([]);// 清空

方式四：拖拽上传（模拟 Drag & Drop）

// 创建 DataTransfer 对象模拟拖拽awaitpage.evaluate(async({filePath})=>{constinput=document.querySelector('input[type="file"]')asHTMLInputElement;constfile=awaitfetch(filePath).then(r=>r.blob()).then(b=>newFile([b],'test.jpg'));constdt=newDataTransfer();dt.items.add(file);input.files=dt.files;input.dispatchEvent(newEvent('change',{bubbles:true}));},{filePath:'http://example.com/test.jpg'});// 或本地路径需特殊处理

2.文件下载（File Download）

test('文件下载并验证',async({page})=>{// 监听下载事件const[download]=awaitPromise.all([page.waitForEvent('download'),// 等待下载开始page.getByRole('link',{name:'下载报告'}).click(),]);// 获取下载对象console.log('文件名:',download.suggestedFilename());// e.g., report.pdf// 保存到指定路径（推荐）constdownloadPath=path.join(__dirname,'../downloads');awaitdownload.saveAs(path.join(downloadPath,download.suggestedFilename()));// 或获取临时路径（headless 模式下有效）consttempPath=awaitdownload.path();// 验证文件存在（结合 Node.js fs）constfs=require('fs');expect(fs.existsSync(tempPath)).toBeTruthy();// 可选：取消下载// await download.cancel();});

注意：

在 headless 模式下，下载的文件保存在临时目录，download.path()可用。
在 headed 模式下，默认弹出系统保存对话框，download.path()会返回 null。建议测试时统一使用 headless。

3.结合 Node.js fs 进行本地文件操作

Playwright 测试运行在 Node.js 环境中，可以自由使用fs模块读写文件，常用于：

准备测试数据
验证下载文件内容
生成临时文件

importfsfrom'fs';importpathfrom'path';test('验证下载文件内容',async({page})=>{// ...触发下载代码同上constsavedPath=path.join(__dirname,'../downloads/report.pdf');awaitdownload.saveAs(savedPath);// 读取文件内容验证constbuffer=fs.readFileSync(savedPath);expect(buffer.length).toBeGreaterThan(1000);// 大于 1KB// 或验证文件类型（PDF 开头 %PDF）expect(buffer.toString('utf8',0,5)).toBe('%PDF-');// 测试后清理fs.unlinkSync(savedPath);});

4.playwright.config.ts 中配置下载路径（可选）

import{defineConfig}from'@playwright/test';exportdefaultdefineConfig({use:{// 统一设置下载目录downloadsPath:'downloads',},});

然后download.path()会直接返回该目录下的路径。

5.Python 版文件操作示例

fromplaywright.sync_apiimportsync_playwrightimportoswithsync_playwright()asp:browser=p.chromium.launch(headless=True)page=browser.new_page()page.goto("https://example.com/upload")# 上传page.get_by_label("选择文件").set_input_files("tests/files/test.pdf")# 下载withpage.expect_download()asdownload_info:page.get_by_text("下载").click()download=download_info.value download.save_as("downloads/myfile.pdf")# 验证文件大小assertos.path.getsize("downloads/myfile.pdf")>1000browser.close()