自动化测试 / 系统课时
配置地理与权限
配置地理与权限
位置、本地化和权限会直接改变页面看到的日期、语言和浏览器 API 结果。本节用 Playwright Test 在同一个浏览器上下文中配置地理位置、语言、时区与定位权限,并用断言确认模拟环境真的生效。
学习目标
- 使用
test.use()为当前测试文件配置地理位置、语言、时区和权限 - 从页面侧读取
navigator、Intl与 Geolocation API,验证模拟结果 - 区分上下文级环境配置与运行中可变的地理位置
先把环境参数放进 BrowserContext
Playwright 的这些模拟项都作用于浏览器上下文。通过 test.use() 配置后,测试使用的 context 与其中创建的页面会继承同一组环境参数,比在每个测试里重复设置更稳定。
| 配置项 | 作用 | 示例值 |
|---|---|---|
geolocation |
模拟经纬度与精度 | 上海附近坐标 |
locale |
影响 navigator.language、语言协商和本地化格式 |
zh-CN |
timezoneId |
改变浏览器中的时区计算 | Asia/Shanghai |
permissions |
预先授予浏览器权限 | geolocation |
地理位置与权限要配套使用:只设置坐标并不等于页面一定有权调用 Geolocation API。权限支持范围还可能因浏览器及版本不同而变化,因此跨浏览器项目应分别执行验证。
用一个测试验证四项模拟
下面的测试访问安全来源 https://example.com,从页面 JavaScript 环境读取语言、时区和当前位置。坐标保留四位小数,避免输出被无关精度干扰。
ts
import { test, expect } from '@playwright/test';
test.use({
geolocation: {
latitude: 31.2304,
longitude: 121.4737,
accuracy: 100,
},
locale: 'zh-CN',
timezoneId: 'Asia/Shanghai',
permissions: ['geolocation'],
});
test('模拟地区环境', async ({ page }) => {
await page.goto('https://example.com');
const environment = await page.evaluate(async () => {
// Geolocation API 是异步接口,先等待浏览器返回模拟坐标。
const position = await new Promise<GeolocationPosition>((resolve, reject) => {
navigator.geolocation.getCurrentPosition(resolve, reject);
});
return {
language: navigator.language,
timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
latitude: Number(position.coords.latitude.toFixed(4)),
longitude: Number(position.coords.longitude.toFixed(4)),
};
});
expect(environment).toEqual({
language: 'zh-CN',
timezone: 'Asia/Shanghai',
latitude: 31.2304,
longitude: 121.4737,
});
console.log(JSON.stringify(environment));
});预期输出
text
{"language":"zh-CN","timezone":"Asia/Shanghai","latitude":31.2304,"longitude":121.4737}测试运行器还会输出用例通过信息,具体耗时会随机器变化。关键是页面侧读取到的四项值与上下文配置一致。
运行中修改位置时要注意作用域
地理位置是少数可以在上下文创建后继续修改的模拟项。需要测试“用户从一个城市移动到另一个城市”时,可调用 context.setGeolocation(...);修改会影响该上下文中的所有页面,而不是只影响当前 page。
locale 和 timezoneId 更适合作为上下文创建参数。如果同一套用例要覆盖多种地区组合,通常为不同测试项目或 test.describe() 分组设置不同环境,而不是在一个测试中反复切换。
当目标是验证某个地区条件下的页面行为时,应同时断言“环境已模拟成功”和“业务页面做出了正确响应”。这样即使权限或浏览器支持发生变化,也能快速判断失败来自测试环境还是业务逻辑。
按自己的节奏,确认真正理解。