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 嗎?
不要。官方寫動作前會等元素可操作,非同步斷言會等到條件成立。手動等待不是讓第一條變綠的辦法。