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 にならない。
先に自分の URL へ変える
サンプルは 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 はパッケージ版を固定しない。
期待するタイトルは先にルームへ。 ルーム ID を送り、ホワイトボード に必須の語を書く。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 は要るか
不要。操作前に操作可能になるまで待ち、非同期マッチャは条件まで待つ、と公式にある。手動待ちで最初のテストを緑にしない。