npx playwright test 退出码 0
第一次成功是一条退出码为 0 的 npx playwright test,不是装完依赖就停。
Playwright 第一次算跑通,不是依赖装完,而是终端里一条 npx playwright test,进程退出码 0。官方示例打开的是 playwright.dev。标题里必须出现的字,先去 wbstorm 开一间房间 写在白板上。
对照 playwright.dev/docs/intro,你要的结果是 默认无头、三个浏览器都通过、进程退出码 0。脚手架文件是 tests/example.spec.ts。
绿之前先别改示例
Node 不在名单里
intro 写的是最新的 22.x、24.x 或 26.x。macOS 要 14(Sonoma)或更新。版本不对,初始化就会停。
浏览器二进制没装
Install Playwright browsers 默认是 yes。选 no,就没有 Chromium、Firefox、WebKit 可开,这条命令不会是 0。
先改成自己的网址
示例打开 https://playwright.dev/,断言标题含 Playwright,再点 Get started,标题 Installation 可见。先让这份文件退出 0,再换 URL。
按官方文档跑到退出码 0
- 1
核对系统要求
Node.js:最新 22.x、24.x 或 26.x。Windows 11+、Windows Server 2019+ 或 WSL。macOS 14+。Debian 12/13,Ubuntu 22.04 / 24.04 / 26.04(x86-64 或 arm64)。
- 2
初始化,不覆盖已有测试
执行
npm init playwright@latest。确认 TypeScript 或 JavaScript、测试目录(默认tests,已有 tests 则默认e2e)、是否加 GitHub Actions、是否安装浏览器(默认 yes)。重跑不会覆盖已有测试。yarn:yarn create playwright。pnpm:pnpm create playwright。 - 3
看它写下了什么
playwright.config.ts集中写浏览器、超时、重试、projects、reporter。tests/example.spec.ts是最小示例。已有项目只是往当前 package.json 加依赖。 - 4
跑,并看退出码
npx playwright test。默认无头,Chromium、Firefox、WebKit 并行。三个项目都过,进程退出码才是 0。只跑一个:npx playwright test --project=chromium。看窗口加--headed。只跑这一文件:npx playwright test tests/example.spec.ts。
| 命令 | 官方行为 | 第一次怎么用 |
|---|---|---|
| npx playwright test | 无头,三浏览器并行 | 退出码 0 才算跑通 |
| --project=chromium | 只跑一个 project | 先缩小失败面 |
| show-report | 失败才自动打开 | 全绿要手动开 |
示例里那两条断言
import { test, expect } from '@playwright/test';
test('has title', async ({ page }) => {
await page.goto('https://playwright.dev/');
await expect(page).toHaveTitle(/Playwright/);
});
test('get started link', async ({ page }) => {
await page.goto('https://playwright.dev/');
await page.getByRole('link', { name: 'Get started' }).click();
await expect(page.getByRole('heading', { name: 'Installation' })).toBeVisible();
});动作前会等元素可操作,断言会等到条件成立,不必手写 sleep。每条测试一块新的 Browser Context,等于新的浏览器配置。已装版本用 npx playwright --version 看,intro 不钉死一个包版本号。
预期标题先落在房间里:发 房间号,在 白板 上写下标题必须含什么。wbstorm 不运行 Playwright,测试仍在你的仓库里。
退出码不是 0 怎么办?
看终端里失败的是哪个 project。HTML 报告会自动打开。浏览器没装就重跑初始化并选安装,或执行文档里的 npx playwright install --with-deps。
可以只跑 Chromium 吗?
可以。npx playwright test --project=chromium。默认配置仍是三个浏览器一起跑,第一次全绿以那条不带 project 的命令为准。
示例为什么打开 playwright.dev?
writing-tests 里的第一份测试就是这样写的:标题匹配 /Playwright/,点 Get started 后标题 Installation 可见。换你的 URL 放在第一次退出 0 之后。
要加 waitForTimeout 吗?
不要。官方写动作前会等元素可操作,异步断言会等到条件成立。手动等待不是让第一条变绿的办法。