自动化测试 / 系统课时

配置地理与权限

配置地理与权限

位置、本地化和权限会直接改变页面看到的日期、语言和浏览器 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() 分组设置不同环境,而不是在一个测试中反复切换。

当目标是验证某个地区条件下的页面行为时,应同时断言“环境已模拟成功”和“业务页面做出了正确响应”。这样即使权限或浏览器支持发生变化,也能快速判断失败来自测试环境还是业务逻辑。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置地理与权限

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通