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。

初始化example.spec.ts退出碼 0

綠之前先別改示例

01

Node 不在名單裡

intro 寫的是最新的 22.x、24.x 或 26.x。macOS 要 14(Sonoma)或更新。版本不對,初始化就會停。

02

瀏覽器二進位沒裝

Install Playwright browsers 預設是 yes。選 no,就沒有 Chromium、Firefox、WebKit 可開,這條命令不會是 0。

03

先改成自己的網址

示例打開 https://playwright.dev/,斷言標題含 Playwright,再點 Get started,標題 Installation 可見。先讓這份檔案退出 0,再換 URL。

按官方文件跑到退出碼 0

  1. 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. 2

    初始化,不覆蓋已有測試

    執行 npm init playwright@latest。確認 TypeScript 或 JavaScript、測試目錄(預設 tests,已有 tests 則預設 e2e)、是否加 GitHub Actions、是否安裝瀏覽器(預設 yes)。重跑不會覆蓋已有測試。yarn:yarn create playwright。pnpm:pnpm create playwright。

  3. 3

    看它寫下了什麼

    playwright.config.ts 集中寫瀏覽器、逾時、重試、projects、reporter。tests/example.spec.ts 是最小示例。已有專案只是往當前 package.json 加依賴。

  4. 4

    跑,並看退出碼

    npx playwright test。預設無頭,Chromium、Firefox、WebKit 並行。三個專案都過,行程退出碼才是 0。只跑一個:npx playwright test --project=chromium。看視窗加 --headed。只跑這一檔:npx playwright test tests/example.spec.ts。

3 瀏覽器
Chromium、Firefox、WebKit
0 視窗
預設無頭
0 退出碼
三個專案都通過
命令官方行為第一次怎麼用
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 嗎?

不要。官方寫動作前會等元素可操作,非同步斷言會等到條件成立。手動等待不是讓第一條變綠的辦法。

建立房間