自动化测试 / 系统课时
测试响应式布局
测试响应式布局
响应式测试的重点不是“页面能不能打开”,而是同一功能在不同视口下是否切换到正确布局,并且关键交互仍然可用。本课用 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 的设备描述配置,让浏览器上下文同时获得这些设备特征。
响应式测试最好把“布局切换”和“交互仍可完成”放在同一业务验收中:前者防止断点样式回归,后者防止移动端入口虽然出现,却因为事件或覆盖层问题实际不可操作。
按自己的节奏,确认真正理解。