Nstproxy 现已升级为 Nstdata。了解此次变化。
周一至周五 09:00 - 18:00(UTC+08:00) 公司地址
19H MAXGRAND PLAZA NO.3 TAI YAU STREET SAN PO KONG, KOWLOON HONG KONG ©2026 NST LABS TECH LTD. 保留所有权利。
Marcus Chen Product & Network Architect
如何使用 Cloud Browser 做网站端到端 QA TL;DR
云浏览器测试在托管浏览器中运行应用程序的用户旅程,而你的测试运行器负责断言和报告。
使用合成商店验证登录、目录搜索和不收取付款的结账预览。
在每个检查点定义一个可观察的接受条件,并记录第一个失败的步骤。
将成功的作业输出、私有诊断和确认的浏览器清理作为单独的信号保留。
管理的Chromium运行是你的测试矩阵中的一种环境。根据你支持的浏览器匹配引擎覆盖。
在并行化更改服务器端状态的测试之前,从孤立的工作区和账户开始。
云浏览器测试用于端到端QA是什么?
云浏览器测试在托管浏览器中执行端到端的用户旅程,并将断言结果返回给运行测试的工作者。端到端测试应该证明一个有意义的应用程序结果。能够打开商店但无法找到SKU或访问授权预览的用户尚未完成旅程。Nstdata Cloud Browser 。
本指南检查一个合成商店。驱动程序输入演示身份,选择目录装置,并验证结账预览。用户旅程跨越三个应用程序状态,并以确切的项目和数量结束。没有付款或外部账户。在批准的临时环境中使用相同的序列,使用你自己模拟的网关和测试数据合约。 Playwright测试最佳实践 描述了为什么用户可见的断言使旅程对实现更改具有鲁棒性。
你应该测试旅程的哪些部分?
测试少数几个其失败会阻碍真实用户目标的检查点。例如,达到经过身份验证的工作区、找到产品以及查看正确的结账摘要形成一个连贯的接受测试。验证目标SKU和数量,以便一般结账标签无法通过错误结果。
检查点 动作 证据 打开临时环境 访问允许的商店路由 成功的HTTP状态和预期的来源 登录演示 提交指定的合成身份 工作区标题出现 搜索 查询一个种子项目名称 可见的匹配项目标题 预览结账 单击模拟预览操作 确切的SKU和数量以及明确的测试专用状态 清理 关闭测试驱动程序并结束会话 记录测试结果并确认管理的会话已结束
测试运行器可以记录哪个阶段失败,而不必存储每个输入值。记录你的测试修订版和装置修订版,以便稍后可以重现输出。对于一个完整的生产级测试程序,你还需要更窄的应用程序逻辑和合约错误测试。当浏览器旅程失败时,这些测试使根本原因更容易定位。
你如何准备一致的QA环境?
准备一个种子装置、一个被授权的测试账户(如有必要)、一个可预测的URL和一个明确的网络配置。使用Node.js 22.12或更高版本,并安装playwright-core@1.65.1。使用npx playwright-core install chromium为本地路径安装Chromium。对于远程路径,使装置可以从托管浏览器访问,并选择一个允许的工作区。在比较本地和管理的运行时保留测试用例、种子数据和接受标准。
如果测试更新了共享设置或记录,则分离测试账户。多个工作者使用的一个账户可能会将测试失败转变为跨工作者冲突。将认证文件和Cookie视为凭据。避免用屏幕截图或日志分发它们,仅使用批准的登录方法进行临时操作。 。
Playwright认证指南
你如何运行登录、搜索和结账QA? 对本地装置或连接到你的临时URL的管理浏览器运行相同的有界检查点序列。此示例使用没有真实权限的测试身份和模拟结账屏幕。
步骤1. 启动种子装置 保存fixture.mjs。在第一个终端中运行node fixture.mjs。提供的仅限于临时的代码在/shop上渲染演示商店。当你将练习移至临时环境时,使用具有相同输入标签的批准路由或更新相应的定位器和断言。
import { createServer } from 'node:http' ;
const receipts = new Map ( ) ;
const pages = {
'/shop' : '<h1>Test storefront</h1><label>Test username <input id="user"></label><button id="signin">Sign in to demo</button><main></main><script>document.querySelector("#signin").onclick=()=>{ if(document.querySelector("#user").value==="qa-demo"){document.querySelector("main").innerHTML=\'<h2>QA workspace</h2><label>Catalog search <input type="search" id="query"></label><button id="search">Search catalog</button><section></section>\'; document.querySelector("#search").onclick=()=>{if(document.querySelector("#query").value==="Paper Atlas"){document.querySelector("section").innerHTML=\'<h2>Paper Atlas</h2><button id="preview">Preview test checkout</button><p role="status"></p>\';document.querySelector("#preview").onclick=()=>document.querySelector("[role=status]").textContent="TEST-SKU-01 × 1 — No payment collected";}};}};</script>' ,
} ;
createServer ( async ( req , res ) => {
if ( ! Object . hasOwn ( pages , req . url ) ) { res . writeHead ( 404 ) . end ( ) ; return ; }
res . writeHead ( 200 , { 'content-type' : 'text/html; charset=utf-8' } ) ;
res . end ( '<!doctype html><html lang="en"><meta charset="utf-8"><body>' + pages [ req . url ] ) ;
} ) . listen ( Number ( process . env . FIXTURE_PORT || 4173 ) , '127.0.0.1' , function ( ) {
console . log ( 'Fixture listening on ' + this . address ( ) . port ) ;
} ) ;
第2步. 配置浏览器驱动 保存下面共享的模块。对于托管会话,打开 Cloud Browser → Playground ,选择工作区并启动浏览器。使用 NSTDATA_API_KEY 和 NSTDATA_SESSION_ID 设置商业 API 密钥和会话 ID。针对已加入团队的个人密钥可能还需要 NSTDATA_TEAM_ID。只能在托管浏览器可以访问的暂存 URL 上运行。云附件需要工作区凭据。测试的浏览器操作和检查点在隔离的 Chromium 中运行。请遵循 Nstdata 浏览器自动化 。
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 runPage ( task , localOptions = { } ) {
const remote = Boolean ( process . env . NSTDATA_SESSION_ID || process . env . LOCAL_CDP_URL ) ;
let browser ;
let page ;
try {
if ( remote ) {
const auth = await endpoint ( ) ;
browser = await chromium . connectOverCDP ( auth . endpoint , {
headers : auth . headers , timeout : 20_000 ,
} ) ;
} else {
browser = await chromium . launch ( ) ;
}
const context = remote ? browser . contexts ( ) [ 0 ] : await browser . newContext ( localOptions ) ;
if ( ! context ) throw new Error ( 'Browser context missing' ) ;
page = await context . newPage ( ) ;
page . setDefaultTimeout ( 10_000 ) ;
await task ( page ) ;
} finally {
try {
await page ?. close ( ) ;
} finally {
await browser ?. close ( ) ;
}
}
}
第 3 步。执行旅程 保存 qa.mjs。对于本地示例运行 TARGET_URL=http://127.0.0.1:4173/shop node qa.mjs。成功运行会打印最终检查点和种子项目。默认超时限制了停滞的定位器检查。如果某个阶段失败,测试将记录该阶段并尝试拍摄一个私有屏幕截图。生产 CI 作业还应保留安全的作业 ID 和构建修订以及其输出。
import assert from 'node:assert/strict' ;
import { runPage } from './run-page.mjs' ;
const origin = new URL ( process . env . TARGET_URL ) ;
await runPage ( async page => {
let step = 'open' ;
try {
const opening = await page . goto ( new URL ( '/shop' , origin ) . href ) ;
assert ( opening ?. ok ( ) ) ;
step = 'sign-in' ;
await page . getByLabel ( 'Test username' , { exact : true } ) . fill ( 'qa-demo' ) ;
await page . getByRole ( 'button' , { name : 'Sign in to demo' } ) . click ( ) ;
await page . getByRole ( 'heading' , { name : 'QA workspace' , exact : true } ) . waitFor ( ) ;
step = 'search' ;
await page . getByRole ( 'searchbox' , { name : 'Catalog search' } ) . fill ( 'Paper Atlas' ) ;
await page . getByRole ( 'button' , { name : 'Search catalog' } ) . click ( ) ;
await page . getByRole ( 'heading' , { name : 'Paper Atlas' , exact : true } ) . waitFor ( ) ;
step = 'checkout-preview' ;
await page . getByRole ( 'button' , { name : 'Preview test checkout' } ) . click ( ) ;
const preview = page . getByRole ( 'status' ) . filter ( { hasText : 'TEST-SKU-01 × 1' } ) ;
await preview . waitFor ( ) ;
assert . match ( await preview . innerText ( ) , / No payment collected / ) ;
console . log ( JSON . stringify ( { accepted : true , step , sku : 'TEST-SKU-01' } ) ) ;
} catch {
await page . screenshot ( { path : 'private-qa-failure.png' } ) . catch ( ( ) => { } ) ;
throw new Error ( 'Staging QA failed at ' + step ) ;
}
} ) ;
真实结账测试必须使用经过您团队批准的模拟或沙箱支付流程。使用一个分阶段断言来证明正确的测试产品和数量。如果您的环境保留购物车,请在每次运行之前种子或重置购物车。在并行性增加时,隔离显得更加重要。争抢修改同一个购物车是测试设置缺陷,即使浏览器并发良好。
第 4 步。检查证据并结束会话 运行已知失败的固件,例如故意不匹配的预期项目,以验证第一个失败检查点和非零退出。在共享之前,先查看私有屏幕截图。如果托管浏览器属于该运行,则从仪表板停止它并等待结束状态。独立存储任务裁决和停止确认。请参见 会话生命周期指南 。
[截图:显示种子 SKU 和仅测试状态的分阶段结账预览,已删除任何工作区标识符。]
您应该如何诊断不稳定的浏览器 QA? 在启用重试之前检查哪一个检查点发生了更改。如果搜索请求成功但项目从未出现,请检查渲染的页面和预期的固件。如果测试间歇性打开登录屏幕,请验证帐户设置以及是否期望一个新会话。失败运行的屏幕截图可以显示错误页面或意外覆盖,而跟踪可以解释操作时机。 跟踪查看器文档 。
症状 可能的层 要检查的内容 浏览器连接在打开页面之前失败 会话或 CDP 原始会话准备情况和实时凭证 结果在重试中波动 固件或应用准备情况 种子版本、帐户隔离和预期结果 预览显示不同的项目 应用状态 购物车重置和精确 SKU 断言 仅在串行运行时测试通过 共享状态 专用帐户或隔离测试数据 错误后缺少屏幕截图 浏览器或工件路径 检查原始失败阶段和运行程序存储
Nstdata Cloud Browser 如何适应 QA 堆栈? Nstdata Cloud Browser 提供了用于浏览器自动化和 AI 代理的托管云浏览器。测试运行器可以通过 CDP 连接到会话并驱动它自己的断言。实时视图使得授权操作员在事件发生期间检查原始状态成为可能。内置代理路由可以支持特定的区域性预检查。您的运行器仍然拥有环境隔离、部署上下文、测试帐户和发布决策。
托管的 Chromium。 在需要时为特定的 Chromium 作业使用托管会话,并维护一个单独的引擎矩阵。
实时视图和诊断。 在批准的重现过程中检查活动页面,并将文物限制在失败的检查点。
会话所有权。 将作业和会话 ID 一起记录,以便责任工作者可以在运行后停止会话。
可选录制。 当重现需要归档证据时,在启动前启用。审查捕捉覆盖和保留,以便在依赖播放之前进行查看。
QA 发布检查在推广前需要什么? QA 发布检查需要一个稳定的测试夹具、清晰的阶段特定断言、范围内的失败证据和可靠的清理。在增加并发性之前,确认旅程在隔离中通过一次。确认故意的失败会产生可操作的报告。保留相同的验收测试用于本地和远程的 Chromium,以便可以分别调查环境差异。请参阅 如何通过 CDP 附加 Playwright 。
FAQ Q: 一个云 Chromium 测试是否能证明跨浏览器兼容性?
使用包含每个相关引擎和设备配置的浏览器矩阵。此操作说明通过 CDP 使用 Chromium。
Q: 每个测试是否应该依赖于端到端登录?
在验证行为的一部分时使用端到端登录。对于其他测试,使用经过批准的分阶段认证设置和隔离状态。
Q: 我可以使用实时支付细节运行结账测试吗?
使用沙盒网关或合成结账夹具。将真实的财务细节排除在浏览器作业和文物之外。
Q: 为什么记录第一个失败步骤?
这可以将缺陷缩小到会话启动、身份验证、搜索、结账或清理。单一的成功位无法指示失败的检查点。
Q: 我如何防止工作者干扰?
给每个工作者提供隔离的数据,并在测试写入共享状态时,提供适当的帐户或工作区。在重新运行之前将夹具重置为已知状态。
Marcus Chen
Nov. 19th 2026
从网页抓取、测试到 AI 驱动的自动化,一切都在云端运行。 探索 Cloud Browser →