自动化测试 / 系统课时

测试响应式布局

测试响应式布局

响应式测试的重点不是“页面能不能打开”,而是同一功能在不同视口下是否切换到正确布局,并且关键交互仍然可用。本课用 Playwright 在桌面和移动视口中验证导航显隐、内容列数与移动菜单交互,形成一套可复用的检查方法。

学习目标

  • 使用 page.setViewportSize() 在同一套测试中切换桌面与移动视口
  • 同时验证布局状态和交互行为,避免只比较截图
  • 区分“视口测试”和完整设备模拟的适用边界

视口决定的是布局条件

CSS 响应式规则通常依据 viewport 宽度触发。测试时应先明确断点对应的业务行为,例如桌面端显示完整导航,移动端隐藏导航并显示菜单按钮。不要只断言像素宽度,否则样式稍作调整就会让测试失去业务意义。

桌面与移动视口下的响应式布局差异

用同一测试覆盖两种布局

下面的示例使用 page.setContent() 构造最小响应式页面,因此不依赖外部服务。测试先检查桌面布局,再切换到移动视口,并点击菜单按钮验证移动端导航确实可用。

ts
import { test, expect } from '@playwright/test';

test('responsive layout keeps correct structure and interaction', async ({ page }) => {
  await page.setContent(`
    <style>
      .menu { display: none; }
      .mobile-nav { display: none; }
      .content { display: grid; grid-template-columns: 1fr 1fr; gap: 16px; }
      @media (max-width: 600px) {
        .desktop-nav { display: none; }
        .menu { display: inline-block; }
        .content { grid-template-columns: 1fr; }
      }
    </style>
    <nav class="desktop-nav">Docs Pricing</nav>
    <button class="menu" aria-label="Open menu">Menu</button>
    <nav class="mobile-nav">Docs Pricing</nav>
    <main class="content"><section>A</section><section>B</section></main>
    <script>
      document.querySelector('.menu').addEventListener('click', () => {
        document.querySelector('.mobile-nav').style.display = 'block';
      });
    </script>
  `);

  await page.setViewportSize({ width: 1280, height: 800 });
  await expect(page.locator('.desktop-nav')).toBeVisible();
  await expect(page.getByRole('button', { name: 'Open menu' })).toBeHidden();
  await expect(page.locator('.content')).toHaveCSS('grid-template-columns', /\d+px \d+px/);

  await page.setViewportSize({ width: 390, height: 844 });
  await expect(page.locator('.desktop-nav')).toBeHidden();
  const menuButton = page.getByRole('button', { name: 'Open menu' });
  await expect(menuButton).toBeVisible();
  await expect(page.locator('.content')).toHaveCSS('grid-template-columns', /\d+px/);

  await menuButton.click();
  await expect(page.locator('.mobile-nav')).toBeVisible();
});

预期结果:将代码保存为 responsive.spec.ts 后执行下面的测试命令,桌面布局、移动布局和菜单交互断言都应通过。

bash
npx playwright test responsive.spec.ts

预期输出:

text
1 passed

实际耗时和输出前缀会随机器与 Playwright 版本不同而变化,但通过数量应为 1 passed。

什么时候需要设备模拟

如果业务只依赖 CSS 断点,setViewportSize() 足够直接,失败时也容易判断是哪一个布局规则出错。若功能还依赖触摸能力、移动浏览器 UA、设备像素比或屏幕方向,则应改用 Playwright 的设备描述配置,让浏览器上下文同时获得这些设备特征。

响应式测试最好把“布局切换”和“交互仍可完成”放在同一业务验收中:前者防止断点样式回归,后者防止移动端入口虽然出现,却因为事件或覆盖层问题实际不可操作。

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

目录与阅读设置

阅读设置

17

记录一个想法

测试响应式布局

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

登录哪都通