自动化测试 / 系统课时

管理本地存储数据

管理本地存储数据

测试页面经常会从 localStorage 或 sessionStorage 读取租户、引导步骤、筛选条件等状态。本课用 Playwright 在应用脚本运行前写入这些值,再从页面中读取并断言,避免依赖手工点击才能得到目标状态。

学习目标

  • 区分 localStorage 与 sessionStorage 在测试中的适用边界。
  • 使用 browserContext.addInitScript() 在页面初始化前准备业务状态。
  • 通过页面读取和断言验证存储值是否真正生效。

在应用初始化前写入状态

如果应用在首屏脚本启动时就读取本地存储,先 page.goto() 再写值可能已经错过初始化时机。更稳妥的做法是先向当前 BrowserContext 注册初始化脚本,让它在文档创建后、页面自身脚本执行前写入数据。

下面示例假设被测应用地址由 APP_URL 提供;未设置时使用本地 http://127.0.0.1:3000。初始化脚本只处理目标 Origin,避免同一页面中的第三方 iframe 被误写入状态。

ts
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}`);
});

预期输出

text
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 文件。

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

目录与阅读设置

阅读设置

17

记录一个想法

管理本地存储数据

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

登录哪都通