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. 保留所有权利。
Playwright 请求拦截:减少浏览器流量
Marcus Chen Product & Network Architect
如何通过请求拦截减少浏览器自动化流量 TL;DR
使用 Playwright 请求拦截在授权应用程序上阻止经过验证的可选资源。
在导航之前注册路由,并匹配最小稳定范围,例如一个精确的资产 URL。
保留脚本、API 请求、必要的样式以及任何所需的资产。
在路由之前和之后比较同一应用程序的接受断言,然后单独检查实际提供商使用情况。
路由可能会影响缓存,服务工作者会改变路由能观察到的请求。
运行后移除路由和监听器,如果你的工作拥有浏览器,则停止管理的浏览器。
Playwright 请求拦截何时减少浏览器流量?
当浏览器中止授权任务不需要的资产请求时,Playwright 请求拦截可以减少流量。好的候选者是装饰性图像或自己应用程序中冗余的资源。从一条路径开始,证明任务仍能达到其接受的结果。 Nstdata Cloud Browser 。
在数据驱动的确认工作流中,背景图像可以是可选的,而在视觉 QA 的案例中则是必要的。大的请求也可以发挥多个作用。在阻止一个类别之前,检查资源是否支持可访问性、布局、应用程序初始化、验证或你打算保留的工件。将依赖视为产品行为,并在你操作的页面上验证它们。
该示例使用一个加载单个装饰性 SVG 的暂存目录。预期的业务信号是 目录已准备好 标题。基线必须提供 SVG。处理程序必须中止该确切图像请求。两个运行仍然必须报告预期的标题。
哪些资源应该不去动?
当资源的角色不确定或当它们影响业务任务时,请保持资源不变。首先使用精确的路由。更广泛的过滤器需要更大的回归样本和对变更的明确责任。
资源 初步决定 接受问题 一个装饰性图像在一个拥有的页面上 经验证后为候选 Intended内容仍然可以呈现并被阅读吗? 应用程序脚本或模块 保留 它是否初始化了任务所使用的控件或数据? 结果行的 API 调用 保留 没有它的响应,接受的结果能存在吗? 样式表或字体 为视觉 QA 保留 阻止它会改变布局或文本测量吗? 嵌入式视频 取决于任务 播放是否是接受条件的一部分? 登录或安全请求 保留 应用程序是否需要它们进行授权访问或完整性?
如果你必须广泛减少图像字节,首先调查每组图像的角色和浏览器任务。精确的路线让你进行小而明确的实验。始终在该范围外继续请求。Playwright 支持 URL 匹配器和不同的拦截操作。 Playwright 网络指南 。
如何比较基线和一个路由?
运行同一页面断言两次并比较对于一个已知资产的观察交付。使用 Node.js 22.12 或更高版本并安装 playwright-core@1.65.1。对于本地运行,使用 npx playwright-core install chromium 安装 Chromium。对于管理路由,将批准的测试页面部署到远程浏览器可以访问的地方。
第 1 步。启动可重现的目标 保存 fixture.mjs 并运行 node fixture.mjs。测试页面位于 /catalog,可选资源为 /assets/decorative.svg。在将测试适配为拥有的暂存应用程序时使用精确路径。该夹具没有外部依赖。
import { createServer } from 'node:http' ;
const receipts = new Map ( ) ;
const pages = {
'/catalog' : '<h1>Catalog ready</h1><img width="30" height="30" alt="" src="/assets/decorative.svg">' ,
} ;
createServer ( async ( req , res ) => {
if ( req . url === '/assets/decorative.svg' ) {
res . writeHead ( 200 , { 'content-type' : 'image/svg+xml' } ) ;
res . end ( '<svg xmlns="http://www.w3.org/2000/svg" width="30" height="30"><rect width="30" height="30" fill="blue"/></svg>' ) ;
return ;
}
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 步。准备浏览器驱动程序 保存下面的共享连接模块。 本地运行使用的是隔离的 Chromium。 对于托管运行,请在 Cloud Browser → Playground 中启动,然后设置 NSTDATA_API_KEY、NSTDATA_SESSION_ID 和任何适用的 NSTDATA_TEAM_ID。 使用经过批准的过渡端点。 此路径需要您自己准备的会话和工作区凭证。 路由和接受逻辑是在本地进行了验证。 请参见 attaching Playwright with 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 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 步。 安装并运行狭窄路径 保存 traffic.mjs 并运行 TARGET_URL=http://127.0.0.1:4173/catalog node traffic.mjs。 基线在没有路由的情况下通过。 处理在导航之前应用一个确切的 URL 匹配。 路由回调检查资源类型再决定是否中止。 URL 匹配器处理来自路由 API 的 URL 对象和来自请求观察的字符串。
import assert from 'node:assert/strict' ;
import { runPage } from './run-page.mjs' ;
const target = new URL ( process . env . TARGET_URL ) ;
const asset = new URL ( '/assets/decorative.svg' , target ) . href ;
const isAsset = url => String ( url ) === asset ;
await runPage ( async page => {
let attempted = 0 ;
let blocked = 0 ;
let delivered = 0 ;
const observe = request => { if ( isAsset ( request . url ( ) ) ) attempted ++ ; } ;
const finish = request => { if ( isAsset ( request . url ( ) ) ) delivered ++ ; } ;
const handler = async route => {
if ( route . request ( ) . resourceType ( ) === 'image' ) {
blocked ++ ;
await route . abort ( ) ;
} else {
await route . continue ( ) ;
}
} ;
page . on ( 'request' , observe ) ;
page . on ( 'requestfinished' , finish ) ;
const check = async ( ) => {
const response = await page . goto ( target . href , { waitUntil : 'load' } ) ;
assert ( response ?. ok ( ) ) ;
await page . getByRole ( 'heading' , { name : 'Catalog ready' , exact : true } ) . waitFor ( ) ;
} ;
await check ( ) ;
assert . equal ( delivered , 1 ) ;
const baseline = { attempted , delivered } ;
attempted = 0 ;
delivered = 0 ;
await page . route ( isAsset , handler ) ;
try {
await check ( ) ;
assert . equal ( attempted , 1 ) ;
assert . equal ( blocked , 1 ) ;
assert . equal ( delivered , 0 ) ;
console . log ( JSON . stringify ( { baseline , attempted , blocked , delivered , accepted : true } ) ) ;
} finally {
await page . unroute ( isAsset , handler ) ;
page . off ( 'request' , observe ) ;
page . off ( 'requestfinished' , finish ) ;
}
} ) ;
预计的固件输出包括 baseline.delivered: 1,blocked: 1,delivered: 0 和 accepted: true。一个完成的请求是浏览器事件,而不是提供商收费记录。这个例子检查交付和内容与一个小的固件。为具有可能在最终行之前出现的骨架的页面构建一个更强的测试谓词。
第4步。移除路由并结束浏览器 [Screenshot: 基线和路由诊断运行的受控目录固件,两者都显示预期的准备就绪标记。]
为什么请求计数和测量的代理使用可能不同步? 请求计数器描述浏览器事件,而提供商使用记录反映服务测量的流量。Playwright观察到的请求可能被中止、缓存、重定向或交付。这使得计数对本地诊断有用,但作为成本计算则不完整。这让运行和提供商使用在同一帐户和时间窗口下进行协调。
路由安装可以禁用HTTP缓存。一个带有浏览器缓存的基线和一个禁用缓存的路由运行可能产生不对称的比较。为了获得更强的基准,比较具有相同缓存条件、配置和固件的单独新鲜会话。如果您需要匹配的路由开销,则比较允许通过的路由与阻止的路由。 Playwright Page.route 参考 。
在添加狭窄路由后可能会出现什么问题? 路由可能会失败,因为URL匹配器过于宽泛、资产需要、路由附加得太晚,或浏览器在其他地方提供了资源。观察确切的失败条件,并为每一个假设添加一个诊断。
如果没有规则触发,请检查实际来源、路径以及应用程序是否使用服务工作者。检查网络视图以了解请求是如何处理的。
如果路由触发,但页面停滞,请检查所需响应和第一个用户可见的检查点。在调查时回滚规则。
如果使用量增加,请比较缓存行为、重定向计数和作业重试。在比较资源使用之前,确认会话是否关闭。
如果测试影响无关的标签,请将路由范围限制在页面或专用上下文中,并在任务完成后将其移除。
如何判断规则是否安全保留? 仅在基线和代表性的路由运行都满足应用程序的接受合同后,才保留路由。在固件中,缺少 目录准备就绪 标题会导致工作者失败,无论计数如何。在一个具有分页的应用中,验证第一个和最后一个案例的预期页面标题和记录ID。如果页面具有响应行为,请测试您知道其提供不同资产的两种大小。
记录源 URL 模式、资产类型、时机、输出计数和服务使用观察。给每条规则一个明确的所有者和回滚条件。如果部署重用相同的资产 URL 用于一个功能组件,则该组件的测试必须在更改到达用户之前发现缺失的依赖项。
Nstdata Cloud Browser 如何支持此实验? Nstdata Cloud Browser 提供用于浏览器自动化和 AI 代理的托管云浏览器。 Playwright 可以通过 CDP 附加,并在所选托管页面中应用有界路由。内置代理在所选设置下承载允许的目标流量。会话历史在可用时提供单独的使用观察。您的应用程序拥有路由规则及其接受和回滚条件。 浏览器自动化文档 。
托管路由。 在一致支持的代理选择下比较,而不需要为您的工作者添加第二个网关。
CDP 执行。 附加后应用相同的页面特定规则,并使其生命周期与测试相关联。
实时故障排除。 检查所选页面的支持诊断,并在您的运行后查看服务测量的使用情况。
明确的成本边界。 分别对浏览器运行时和流量进行核对。 云浏览器定价 。
何时应推出路由? 仅在代表性样本保持相同接受率、展示可重复的使用节省,并通过针对加载不同的页面的测试后再推出。保留确切的路由范围和所有者以便回滚。检查故障的影响并在增加并发性之前确认清理。对于生产调试,保留已清理的网络观察和一个小的接受输出样本。
FAQ Q: 我可以阻止所有图像以节省流量吗?
从一个经过验证的可选图像开始。产品图表、UI 图标、图表或视觉回归工件可能依赖于图像。
Q: 我是否应该将每个观察到的请求都计算为计费流量?
使用浏览器事件验证实验和服务提供商的使用情况以进行流量核算。
Q: 为什么 Playwright 忽略了一个请求?
检查路由注册时间、正确的页面或上下文以及服务工作者行为。
Q: 应用路由会影响缓存行为吗?
Playwright 记录了路由对缓存的影响。在测量节省时,比较等效的缓存设置。
Q: 我还需要结束托管浏览器吗?
是的。页面清理和客户端断开连接并不能完成托管会话生命周期。
Marcus Chen
Nov. 19th 2026
从网页抓取、测试到 AI 驱动的自动化,一切都在云端运行。 探索 Cloud Browser →