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
如何使用云浏览器测试网站本地化 TL;DR
浏览器本地化测试检查用户在特定的出口位置、语言、时区和应用状态下所看到的内容。
代理国家、浏览器语言和时区是单独的 Nstdata 设置。在启动前选择它们并记录每一个。
跟随 IP 应用启动对齐。当结果依赖于区域时,验证实际的退出和页面可见设置。
比较浏览器的语言和时区与应用的可见语言、格式、货币和路由。
一次更改一个信号,以确定是服务器、浏览器还是账户偏好控制结果。
验证观察到的结果,并独立于浏览器客户端的断开结束管理会话。
浏览器本地化测试验证了什么?
浏览器本地化测试验证授权的应用是否为定义的用户上下文显示正确的内容和格式。这可能包括本地化的文案、日期格式、货币、路由和区域功能可用性。测试必须记录站点使用的信号。显而易见的德国网络出口和德语浏览器语言是独立的输入,档案语言偏好可以覆盖任一项。Nstdata Cloud Browser .
开发人员可以通过声称可见的本地化标题和选择的页面语言来证明测试达到了其目标。浏览器的区域设置仅能证明配置,而不能证明实际提供给用户的用户界面。如果应用提供用户可控的语言切换,请与首次访问的启发式方法分开验证。Playwright 模拟指南 文档记录了本地环境的区域和时区设置。
代理国家、语言和时区如何影响测试?
代理国家影响网络出口,浏览器语言表达偏好,而时区则影响浏览器端的日期和时间计算。站点可能通过检查账户设置、Cookie、URL、头信息或区域后端来应用自己的规则。将优先级顺序作为您的应用测试合同的一部分。
信号 典型验证 为什么可能不同 代理国家 可信区域检查或授权的服务器端观察 路由和地理定位数据库可能不同 浏览器语言 navigator.language 和服务器观察到的语言偏好个人设置和应用可能覆盖偏好 浏览器时区 Intl.DateTimeFormat().resolvedOptions().timeZone浏览器配置和代理出口是分开的 页面区域 文档 lang 加上可观察的标题 用户设置、URL 路由或后备策略 货币和日期显示 已知的固定价格和固定时间戳 区域、市场目录、时区和应用规则相互作用
当工作区支持该设置时,跟随 IP 可以在启动时对齐语言和时区。它不会随着出口的变化而持续更新这些字段。选择出口国家也无保证提供固定的专用地址。对于可重复的仅区域实验,使用 自定义 并在会话之间保持代理设置不变。请参阅 Cloud Browser 配置指南 .
如何构建诊断测试矩阵?
构建一个小矩阵,逐次更改一个输入并记录渲染结果。首先记录预期的区域谈判规则。如果您的应用从账户中选择国家,请在评估浏览器语言时保持该账户设置不变。如果它使用区域可用性,请在变化代理地域时保持浏览器设置不变。
情况 出口 语言和时区 需要确认的内容 参考 允许的美国出口 en-US 和 America/New_York预期的英文文案和已知的本地显示 语言变化 与参考相同的国家 de-DE 加上参考时区如果应用遵循浏览器偏好,则为德文文案 时区变化 与参考相同的国家 参考语言与 Europe/Berlin 根据应用要求渲染的固定时间戳 区域变化 另一个允许的可用国家 与参考相同的语言和时区 预期的区域功能或目录响应 账户覆盖 与参考相同的配置 与参考相同的配置 如果指定,则保存的用户偏好生效 不要选择没有授权案例的国家。保持区域价格和语言的独立预期值,而不是从翻译中推断货币。对于日期测试,选择一个稳定的输入时间戳,并记录该功能应显示的日历日期、时间和时区。仅当应用程序合同要求时,才添加一个夏令时边界案例。Intl.DateTimeFormat 参考 。
如何配置和验证 Nstdata Cloud Browser 会话? 在启动之前配置网络和浏览器首选项,然后验证每个决定预期用户体验的信号。
第 1 步。选择网络出口 在预期的工作区中打开 Cloud Browser → Playground 。选择一个可用的 Proxy Country 。在只比较区域时使用相同的国家。如果测试地理位置,请通过授权服务器或受信任区域检查器确认有效出口。
第 2 步。设置自定义浏览器环境 打开浏览器环境设置,并在 Custom 下设置 Browser Language 和 Timezone ,如果适用的话。使用 BCP 47 语言标签和 IANA 时区名称。当前选项决定哪些值被支持。仪表板使用单一语言输入。API 集成可以使用 fingerprint.languages 作为带有 localeMode: "custom" 的有序列表。查询 GET /api/v1/cloud-browser/sessions/options 获取实际选项,并检查任何有效配置警告。
![Screenshot: Browser Language and Timezone configuration before launch.]
第 3 步。启动并开始测试装置 点击 Launch Browser 等待 Running ,如果您正在进行管理测试。对于本地运行,使用 Node.js 22.12 或更高版本,安装 playwright-core@1.65.1 并运行 npx playwright-core install chromium。保存 fixture.mjs,并运行 node fixture.mjs。该装置在请求的语言偏好以 de 开头时选择德语输出。它绑定到回环用于本地测试。对于管理测试,使用经过批准的可到达部署。
import { createServer } from 'node:http' ;
const receipts = new Map ( ) ;
const pages = {
'/locale' : '<h1>Regional demo</h1>' ,
} ;
createServer ( async ( req , res ) => {
if ( req . url === '/locale' ) {
const german = / ^ de \b / i . test ( req . headers [ 'accept-language' ] || '' ) ;
res . writeHead ( 200 , { 'content-type' : 'text/html; charset=utf-8' } ) ;
res . end ( german ? '<!doctype html><html lang="de"><meta charset="utf-8"><h1>Regionales Beispiel</h1>'
: '<!doctype html><html lang="en"><meta charset="utf-8"><h1>Regional demo</h1>' ) ;
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 ) ;
} ) ;
第 4 步。检查并断言应用程序结果 保存共享模块和 locale.mjs。对于英语装置,运行 TARGET_URL=http://127.0.0.1:4173/locale node locale.mjs。对于德语案例设置 EXPECT_LANGUAGE=de-DE,EXPECT_TIMEZONE=Europe/Berlin,EXPECT_PAGE_LANGUAGE=de 和 EXPECT_HEADING="Regionales Beispiel" 在同一个命令中。这个本地分支使用一个新的 Playwright 上下文,进行明确的模拟。管理分支读取现有的远程环境,要求您的工作区使用 NSTDATA_API_KEY 和 NSTDATA_SESSION_ID。在测量提供者配置时避免设置运行时覆盖。请参见 connecting Playwright over 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 ( ) ;
}
}
}
import assert from 'node:assert/strict' ;
import { runPage } from './run-page.mjs' ;
const url = new URL ( process . env . TARGET_URL ) ;
const expected = {
browserLanguage : process . env . EXPECT_LANGUAGE || 'en-US' ,
browserTimezone : process . env . EXPECT_TIMEZONE || 'America/New_York' ,
pageLanguage : process . env . EXPECT_PAGE_LANGUAGE || 'en' ,
heading : process . env . EXPECT_HEADING || 'Regional demo' ,
} ;
await runPage ( async page => {
const response = await page . goto ( url . href ) ;
assert ( response ?. ok ( ) ) ;
const heading = page . getByRole ( 'heading' , { name : expected . heading , exact : true } ) ;
await heading . waitFor ( ) ;
const observed = await page . evaluate ( ( ) => ( {
browserLanguage : navigator . language ,
browserTimezone : Intl . DateTimeFormat ( ) . resolvedOptions ( ) . timeZone ,
pageLanguage : document . documentElement . lang ,
} ) ) ;
assert . deepEqual ( observed , {
browserLanguage : expected . browserLanguage ,
browserTimezone : expected . browserTimezone ,
pageLanguage : expected . pageLanguage ,
} ) ;
console . log ( JSON . stringify ( { observed , heading : await heading . innerText ( ) } ) ) ;
} , { locale : expected . browserLanguage , timezoneId : expected . browserTimezone } ) ;
本地英语和德语用例断言它们的语言、时区、文档语言和文本。在中间环境中,添加一个可见的价格标签和一个固定预期值的日期。检查那些可用户见的值是否通过角色或文本定位器。一个测试可以通过配置检查,但仍然可能显示缺失的翻译。 Playwright 断言文档 。
第 5 步。记录案例并停止浏览器 将配置和观察到的值与预期标题和一个安全的测试用例 ID 一起保存。在测试后从仪表板停止托管会话。分别记录任务接受和确认关闭。请参见 云浏览器会话管理 。
为什么页面仍然可以显示错误的区域设置? 当另一个信号优先于或内容未加载时,页面可以显示意外的区域设置。检查账户或cookie是否保留了早期测试的语言。检查预期路由和最终导航。独立于浏览器首选项验证应用程序的翻译。
如果浏览器语言正确,而页面使用错误语言,请比较应用程序状态、观察到的请求首选项和预期的服务器优先级规则。
如果时区正确而日期不同,请验证固定的源时间戳、格式选项以及断言读取的时间显示。
如果区域看起来不正确,请记录所选国家并观察实际路由通过您的批准验证端点。
如果只有部分字符串被翻译,请检查捆绑包或数据响应失败和回退文本。请参阅 浏览器自动化调试 。
Nstdata 云浏览器如何适应区域 QA? Nstdata 云浏览器提供用于浏览器自动化和 AI 代理的托管云浏览器。其预发布设置使 QA 工作人员能够明确出站和浏览器偏好。实时视图可以帮助在同一运行中的浏览器中重现用户可见的差异。 CDP 让您的自动化确认来自该环境的输出。该应用程序仍然定义用户接收的语言、日期、价格和路线。
集成代理路由。 选择支持的出口国家,无需为内置路径配置单独的网关。
浏览器偏好。 单独设置语言和时区。验证观察到的设置和确切的应用结果。
实时诊断。 在需要调查区域回退时检查所选页面、控制台和网络。
何时可以重复进行本地化测试? 当其配置、观察到的浏览器信号、修订的配置和预期输出能够重现时,本地化测试就准备好了。将参考和一个更改的变量放在证据旁边。在扩展矩阵之前,添加针对新应用规则的目标案例。云浏览器自动化文档 提供了将托管会话与现有测试运行器集成的脚本。
FAQ Q: 代理国家设置浏览器语言吗?
选择在适当时候启动排列的跟随 IP,或明确配置语言。验证网站接收和显示的内容。
Q: 国家选择提供固定 IP 吗?
记录可用国家,并独立验证观察到的出口。选择一个地区并不保证固定地址。
Q: 应用程序可以在德国浏览器中显示英语吗?
可以。该应用程序可能遵循其帐户设置、当前路线或翻译回退规则。
Q: 我应该输入什么时区值?
使用可用的 IANA 时区名称,例如 Europe/Berlin 或 America/New_York,并验证浏览器报告。
Q: 我可以在同一个托管会话中更改所有配置吗?
在启动之前选择预期的托管设置。对于另一个配置,使用新的会话,并保持所有其他测试输入不变。
Marcus Chen
Nov. 19th 2026
从网页抓取、测试到 AI 驱动的自动化,一切都在云端运行。 探索 Cloud Browser →