TL;DR
- 使用
locator.setInputFiles()在已授权的应用程序中进行实际文件输入。 - 在点击打开文件选择器的自定义控件之前,等待
filechooser事件。 - 使用一个小的命名 Buffer 进行合成测试,使用表单所期望的文件名和 MIME 类型。
- 验证文件选择、提交结果和服务器端收据,作为独立的里程碑。
- 保持测试文件不包含机密和个人数据。与预期环境检查当前文件、路径和浏览器限制。
- 关闭您创建的页面,并在其工作完成时确认托管浏览器的结束。
Playwright 如何将文件上传到远程浏览器?
Playwright 通过设置浏览器的文件输入或向捕获的选择器提供文件来上传文件。工作线程从夹具字节开始,页面会启动应用程序操作。您仍需要验证应用程序接收到的内容以及目标交易是否已提交。 Nstdata 提供可通过附加的 Playwright 客户端控制的托管 Chromium 会话。
一个简单的测试可以显示所选的文件名,但仍然无法传输文件。例如,前端显示有效选择,而后台上传接收服务器拒绝。以一个已授权的表单、小的合成文件和已知的服务器收据开始。 Playwright 表单自动化指南 涵盖了提交和证明提交结果之间的相同分离。
何时应该使用文件输入或选择器?
当页面暴露 input[type="file"] 且具有可识别的可访问标签或稳定定位器时,使用文件输入。当应用程序通过按钮打开选择器且输入是临时时,使用文件选择事件。适当的方法取决于已授权的页面如何提供文件选择。
| 应用程序界面 | Playwright 方法 | 接受检查 |
|---|---|---|
| 标记的文件输入 | locator.setInputFiles() | 选择了正确的合成文件,并在提交后预期收据 |
| 按钮触发的选择器 | page.waitForEvent('filechooser') 和 chooser.setFiles() | 点击打开了预期的选择器,并且应用程序接受文件 |
| 选择后立即上传 | 根据 UI 使用文件输入或选择器 | 等待应用程序的持久完成标记 |
| 多文件工作流 | 仅在输入支持时提供预期的文件 | 确认完整的接受集合并处理部分拒绝 |
Playwright 输入文档 描述了路径和内存中文件负载。FileChooser API 参考 记录了在选择器事件后提供文件。命名的 Buffer 使夹具字节自包含,并避免依赖于复制到运行时文件系统中的文件。在使用真实资产之前,验证传输路径和任何适用限制。
您应该为上传测试准备什么?
准备一个批准的测试源、合成文件内容和一个可独立检查的接受规则。记录字段标签、文件类型、允许的大小和预期的文件名或收据格式。将这些细节与您有权限测试的应用程序匹配。可见的预览作为中间信号是有用的。收据或应用程序记录证明服务器是否接受了文件。
还选择一个预期的拒绝案例,比如有效提交但不可接受的文件名。使用您的应用程序现有的测试政策和一个小的有界上传,特别是当操作写数据时。为浏览器外的测试工件设置清理所有者,因为关闭浏览器可能会留下在应用程序中保存的记录。
您如何附加并提交合成文件?
启动伴随夹具,连接浏览器,并将小的测试负载提交到固定的审核页面。此示例使用 Node.js 22 和 playwright-core@1.65.1。使用 npx playwright-core install chromium 和 node fixture.mjs 进行本地运行。夹具绑定到 127.0.0.1,默认在 4173 端口提供 /upload。
第 1 步。确认目标和收据格式
本地应用程序接受名为 fixture.txt 的文件,文件大小为 15 字节。它在 API 读取文件后写入收据,因此测试可以区分正确的确认和空控制。在选择文件之前确认目标使用预期的来源和沙箱帐户。 浏览器自动化设置。
第 2 步。准备浏览器客户端
保存伴侣模块。 本地运行直接启动 Chromium。 隔离的远程客户端测试可以使用验证者的环回 CDP 地址。 对于托管运行,使用一个准备好的、授权的会话,一个可以通过云浏览器访问的批准测试应用,以及文档中记录的 NSTDATA_API_KEY、NSTDATA_SESSION_ID 和可选的 NSTDATA_TEAM_ID 配置。 将密钥与发出的 CDP 凭证分开。 本地浏览器和本地 CDP 分支执行客户端操作。 托管分支需要您自己的工作区授权和等效夹具。
const root = 'https://api.nstdata.io/api/v1/cloud-browser'; export async function api(method, path, body) { const key = process.env.NSTDATA_API_KEY; if (!key) throw new Error('Set NSTDATA_API_KEY'); const headers = { 'x-api-key': key }; if (process.env.NSTDATA_TEAM_ID) headers['x-team-id'] = process.env.NSTDATA_TEAM_ID; if (body) headers['content-type'] = 'application/json'; let response; try { response = await fetch(root + path, { method, headers, redirect: 'error', body: body ? JSON.stringify(body) : undefined, signal: AbortSignal.timeout(20_000), }); } catch { throw Object.assign(new Error('API transport failed; reconcile the original operation'), { retryable: true }); } const retryable = response.status === 429 || response.status >= 500; let result; try { result = await response.json(); } catch { throw Object.assign(new Error('Invalid API JSON'), { retryable }); } if (!response.ok || result.err === true || result.success === false) { throw Object.assign(new Error(`Cloud Browser API HTTP ${response.status}`), { retryable }); } if (!result.data) throw new Error('Missing API data'); return result.data; } export async function connection(id) { if (!id) throw new Error('Set NSTDATA_SESSION_ID'); const path = `/sessions/${encodeURIComponent(id)}`; const session = await api('GET', path); if (session.state !== 'ready') throw new Error(`Session is ${session.state}, not ready`); const c = await api('POST', path + '/automation-credentials'); if (c.sessionId !== id || !c.headerName || !c.accessToken || !(Date.parse(c.expiresAt) > Date.now()) || new URL(c.cdpUrl).protocol !== 'wss:') { throw new Error('Invalid or expired CDP credentials'); } return { endpoint: c.cdpUrl, headers: { [c.headerName]: c.headerName.toLowerCase() === 'authorization' ? `Bearer ${c.accessToken}` : c.accessToken }, }; } export async function endpoint() { // An isolated local CDP endpoint can test the client without managed credentials. if (process.env.LOCAL_CDP_URL) { const url = new URL(process.env.LOCAL_CDP_URL); if (!['127.0.0.1', 'localhost', '[::1]'].includes(url.hostname)) { throw new Error('LOCAL_CDP_URL must use loopback'); } return { endpoint: url.href, headers: {} }; } return connection(process.env.NSTDATA_SESSION_ID); }
import { chromium } from 'playwright-core'; import { endpoint } from './cloud-api.mjs'; export async function withPage(task) { const origin = new URL(process.env.APP_ORIGIN ?? 'http://127.0.0.1:4173'); const remote = Boolean(process.env.LOCAL_CDP_URL || process.env.NSTDATA_SESSION_ID); if (!remote && origin.hostname !== '127.0.0.1') throw Error('Use the local fixture for local runs'); const connection = remote ? await endpoint() : null; const browser = connection ? await chromium.connectOverCDP(connection.endpoint, { headers: connection.headers, timeout: 15_000 }) : await chromium.launch({ args: ['--no-proxy-server'] }); let page; try { const context = remote ? browser.contexts()[0] : await browser.newContext(); if (!context) throw Error('Expected a browser context'); page = await context.newPage(); page.setDefaultTimeout(8_000); page.setDefaultNavigationTimeout(10_000); return await task(page, origin); } finally { try { await page?.close(); } finally { await browser.close(); } } }
第 3 步。 附加测试有效负载
将示例保存为 upload.mjs。 启动测试服务器,然后运行 node upload.mjs。 脚本将名称、MIME 类型和 Buffer 发送到标记输入。 它使用一个精确的控制标签并提交一次。 如果您的真实授权页面仅公开一个选择器,请在单击其按钮之前注册事件 Promise,然后使用验证过的有效负载调用 setFiles()。
import assert from 'node:assert/strict'; import { withPage } from './browser.mjs'; await withPage(async (page, origin) => { const url = new URL('/upload', origin); const navigation = await page.goto(url.href, { waitUntil: 'domcontentloaded' }); assert(navigation?.ok()); assert.equal(new URL(page.url()).origin, url.origin); const content = Buffer.from('fixture upload\n'); const input = page.getByLabel('Test attachment'); await input.setInputFiles({ name: 'fixture.txt', mimeType: 'text/plain', buffer: content }); await page.getByRole('button', { name: 'Submit attachment', exact: true }).click(); const receipt = page.getByText('TEST-RECEIPT | fixture.txt | 15 bytes', { exact: true }); await receipt.waitFor({ state: 'visible' }); console.log(JSON.stringify({ accepted: true, filename: 'fixture.txt', bytes: content.length })); });
第 4 步。等待应用程序的收据
使用与提交的固定件相关的结果并验证接受的内容。在这里,服务器报告文件名和字节数,并且脚本发出精简的接受记录。生产应用程序可能使用上传 ID、待处理扫描状态或持久化工件。等待定义该应用程序中接受的信号。Playwright 可操作性文档描述了成功操作所等待的内容,这与应用程序随后所做的事情是不同的。
[截图:显示测试表单,包含所选的合成文件和确认其字节计数的收据。]
为什么文件可以被选中,而上传仍然失败?
即使应用程序拒绝文件或尚未完成处理,文件也可以出现在输入中。检查产生最后一个可信信号的阶段。定位器超时指向页面或控件。选择文件后出现的服务器错误指向表单验证、请求或后端处理。记录原始文件内容几乎没有诊断价值。
| 症状 | 检查内容 | 安全响应 |
|---|---|---|
| 输入超时 | 标签、正确的页面、iframe 边界 | 在批准的页面内找到意图输入 |
| 选择器事件从未出现 | 控件行为和事件注册顺序 | 在操作之前注册正确的事件 |
| 错误的文件大小 | 固定数据和编码 | 将预期字节与服务器收据进行比较 |
| 提交后缺少收据 | 请求结果和应用程序记录 | 在重新提交之前进行调和 |
浏览器控制台和网络调试指南 有助于区分可见的 UI 结果与响应或传输失败。当您的目标使用后台扫描时,保留上传 ID 并轮询其文档中的安全状态,而不是再次提交文件。
上传作业如何处理验证错误?
上传作业应保留原始尝试并在发送更多字节之前对响应进行分类。在固定件被拒绝时,保留安全文件名、预期大小、响应类别和应用程序收据状态。运行一个故意被拒绝的合成有效负载,修改一个字段,并验证 UI 报告拒绝而不创建接受记录。如果第一个请求可能成功且收据缺失,请使用其上传标识符或其他只读状态视图咨询应用程序。
将每个负面测试绑定到一个在明确批准的固定件拒绝环境中的小文件。存储简单的诊断记录,并使用目标的预期清理过程清除任何持久化的测试数据。
Nstdata Cloud Browser 如何适应上传 QA?
Nstdata Cloud Browser 提供了受管理的 Chromium 运行时,以支持授权文件工作流。Playwright 脚本仍会构建文件输入,执行预期的表单操作,并验证应用程序记录的内容。实时视图或允许的浏览器诊断可以帮助操作员调查通过多个 UI 阶段的上传。访问目标应用程序、文件约束和删除存储的测试数据仍然是您应用程序设计的一部分。
- 远程连接。 使用拥有的会话和经过验证的目标页面的支持 CDP 工作流。
- 可复现的固定件。 在工作程序中保留一个小的已批准字节负载,并确认预期的服务器收据。
- 故意清理。 关闭您拥有的页面并单独停止受管理的浏览器;通过应用程序的批准路径删除测试记录。
可重复的上传烟雾测试应该证明什么?
可重复的上传烟雾测试应证明所选的文件是预期的,服务器接受了一次,并且浏览器和保存的固定件工件已识别出清理所有者。首先,从允许的最小样本开始,验证成功接收和验证失败。当间歇性结果需要审查时,请使用云浏览器会话重放工作流程与合成数据和批准的保留。
FAQ
Q: Playwright 可以将 Buffer 附加到文件输入吗?
可以。使用一个具有 name、mimeType 和 buffer 的对象作为文档化的文件输入 API。
Q: 如果上传按钮打开本地选择器怎么办?
在单击之前等待页面的 filechooser 事件,然后通过返回的选择器提供文件负载。
Q: 文件预览证明服务器接受了吗? 检查持久的应用程序收据或状态。预览主要证明客户端知道选择了哪个文件。
Q: 如果响应丢失,应该重试提交吗? 首先检查原始上传记录。仅当您可以在应用程序的规则下建立安全结果时,才重复提交。
Q: 云会话可以打开本地固定件 URL 吗? 云浏览器有自己的网络环境。使用云浏览器可以访问的等效批准的预发布固定件,或在本地浏览器路径上运行测试。




