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

先に自分の URL へ変える

サンプルは 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=chromiumproject を一つ失敗面を狭める
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 は要るか

不要。操作前に操作可能になるまで待ち、非同期マッチャは条件まで待つ、と公式にある。手動待ちで最初のテストを緑にしない。

無料で会議を開始