Playwright 速查
共 27 条 Playwright 端到端测试，涵盖命令、测试结构、定位与操作、断言与等待、网络与多浏览器。 支持搜索与分类筛选，点击即可复制。
命令
内置测试运行器。
| 命令 | 说明 |
|---|---|
| 初始化项目（含示例与配置） | |
| 运行测试 | |
| UI 模式（可视化调试） | |
| 录制生成测试代码 | |
| 指定浏览器 / 显示界面 | |
| 查看 HTML 报告 |
测试结构
test 与 expect。
| 命令 | 说明 |
|---|---|
| 引入 | |
| 定义用例（fixture 注入 page） | |
| 分组 | |
| 打开页面 | |
| 前置钩子 | |
| 跳过 / 只跑 / 待修复 |
定位与操作
推荐面向用户的定位器。
| 命令 | 说明 |
|---|---|
| 按角色与可访问名定位（推荐） | |
| 按文本 / 标签定位 | |
| CSS 选择器 | |
| 常用操作 | |
| 筛选元素 |
断言与等待
自动等待，无需手写 sleep。
| 命令 | 说明 |
|---|---|
| 可见性断言 | |
| 文本断言 | |
| URL 断言 | |
| 显式等待 | |
| 元素数量断言 |
网络与多浏览器
拦截、多项目与追踪。
| 命令 | 说明 |
|---|---|
| 拦截并模拟响应 | |
| 等待响应 | |
| 在配置中同时跑多浏览器 | |
| 开启追踪（Trace Viewer 回放） | |
| 模拟移动设备 |
使用说明
Playwright 速查：命令、测试结构、定位与操作、断言与等待、网络与多浏览器；支持搜索与分类筛选，点击即可复制。
- 按用途点分类：命令、测试结构、定位与操作、断言与等待、网络与多浏览器。
- 点「命令」列复制到 *.spec.ts 或终端。
- 优先用 getByRole / getByLabel 等面向用户的定位器，更稳也更能暴露可访问性问题。
- 失败用 trace 回放（npx playwright show-report）快速定位。
常见问题
- 为什么不用 CSS 选择器？
- CSS 选择器易随样式重构而失效；语义定位器（角色/文本/标签）更贴近真实用户行为，维护成本低。
- 能跑多浏览器吗？
- 可以：在配置里配 projects（chromium/firefox/webkit），一次运行覆盖多引擎，还能模拟移动设备。
- 需要联网吗？
- 不需要，本地可用（安装浏览器需联网）。