自动化测试 / 系统课时
管理本地存储数据
管理本地存储数据
测试页面经常会从 localStorage 或 sessionStorage 读取租户、引导步骤、筛选条件等状态。本课用 Playwright 在应用脚本运行前写入这些值,再从页面中读取并断言,避免依赖手工点击才能得到目标状态。
学习目标
- 区分
localStorage与sessionStorage在测试中的适用边界。 - 使用
browserContext.addInitScript()在页面初始化前准备业务状态。 - 通过页面读取和断言验证存储值是否真正生效。
在应用初始化前写入状态
如果应用在首屏脚本启动时就读取本地存储,先 page.goto() 再写值可能已经错过初始化时机。更稳妥的做法是先向当前 BrowserContext 注册初始化脚本,让它在文档创建后、页面自身脚本执行前写入数据。
下面示例假设被测应用地址由 APP_URL 提供;未设置时使用本地 http://127.0.0.1:3000。初始化脚本只处理目标 Origin,避免同一页面中的第三方 iframe 被误写入状态。
import { test, expect } from '@playwright/test';
const APP_URL = process.env.APP_URL ?? 'http://127.0.0.1:3000';
test('prepare and verify browser storage', async ({ context, page }) => {
const seed = {
targetOrigin: new URL(APP_URL).origin,
tenantId: 'qa-tenant',
wizardStep: '2',
};
// 在应用自己的脚本运行前注入状态,并限制到目标 Origin。
await context.addInitScript(({ targetOrigin, tenantId, wizardStep }) => {
if (location.origin !== targetOrigin) return;
localStorage.setItem('tenantId', tenantId);
sessionStorage.setItem('wizardStep', wizardStep);
}, seed);
await page.goto(APP_URL);
const storage = await page.evaluate(() => ({
tenantId: localStorage.getItem('tenantId'),
wizardStep: sessionStorage.getItem('wizardStep'),
}));
expect(storage).toEqual({
tenantId: 'qa-tenant',
wizardStep: '2',
});
console.log(`localStorage tenant = ${storage.tenantId}`);
console.log(`sessionStorage wizardStep = ${storage.wizardStep}`);
});预期输出
localStorage tenant = qa-tenant
sessionStorage wizardStep = 2测试运行器还会输出用例名称、耗时等信息,具体行数可能不同;关键是两项断言通过且打印值与准备的数据一致。
选择 localStorage 还是 sessionStorage
localStorage 适合需要在同一 Origin 下跨页面导航继续存在的状态,例如主题、租户选择或已完成的引导标记。Playwright 的 storageState 可以保存和恢复其中的本地存储数据,因此它也适合需要在新 BrowserContext 中复用的状态。
sessionStorage 更适合只属于当前标签页会话的临时业务状态。它不会由 Playwright 的 storageState 自动持久化;如果必须跨新上下文复用,应自行序列化后,再通过 addInitScript() 恢复。不要把二者当成完全等价的键值容器。
验证业务结果而不只验证键值
直接断言存储值能确认准备步骤成功,但最终测试最好继续验证这些值是否影响了页面。例如 tenantId=qa-tenant 应让页面展示对应租户的数据,wizardStep=2 应让向导进入第二步。这样可以防止“键写进去了,但应用根本没有消费它”的假阳性。
同一个 Playwright 测试默认拥有隔离的浏览器上下文,因此测试结束后这些本地状态会随上下文一起丢弃。只要不复用持久化 Profile,就不需要在每个测试末尾手工清空存储;真正需要关注的是测试之间是否共享了同一份 storageState 文件。