本文へ移動
技術を、自社の仕事に。
判断と実行を助けるメディア

記事を検索

Playwright 1.65 ページオブジェクトが落ちる変更とBun対応

目次 · 7項目

Webサイトの公開前の確認をPlaywrightで自動化し、依存ライブラリの更新を自動のプルリクエストで取り込んでいる場合の話です。テストのコードを1行も変えていないのに、更新を取り込んだ途端にページオブジェクトのクラスで TypeError が出る。Playwright 1.65.0(npmへの公開は2026年11月5日、UTC)では、こうしたことが起こります。

公式のリリースノートは、1.65の破壊的な変更(リポジトリの文書では「Breaking Changes」、GitHubのリリースのページでは「Notable Changes」の見出し)として、TypeScriptのクラスのフィールドが tsconfig.json の useDefineForClassFields に従うようになったことを挙げています。本記事では、1.64.1と1.65.0で同じテストを動かして再現した結果と直し方、あわせて新しく対応したBunでの実行を確かめた結果をまとめます。

落ちるのは、フィールドの初期化でコンストラクターの引数を読むクラス

リリースノートの説明は次のとおりです。useDefineForClassFields は、target が ES2022 以降のとき、また target を指定していないときに有効になり、tsc と同じ扱いになります。有効だと、フィールドの初期化子がコンストラクターより先に動くため、コンストラクターの引数で宣言したプロパティ(パラメータープロパティ)を読む初期化子は失敗します。

リリースノートの例は、次のようなページオブジェクトです。

class LoginPage {
  // 1.65では、this.page がまだ undefined のまま読まれる
  readonly submit = this.page.getByRole('button', { name: 'Submit' });

  constructor(private readonly page: Page) {}
}

1.64.1と1.65.0で同じテストを動かした

2026年11月13日に、作業用のディレクトリで確かめました。環境はUbuntu 24.04.5、Node.js 22.23.4、TypeScript 5.9.3、tsconfig.json の target は ES2022 です。ブラウザーを起動しないよう、page の代わりに普通のオブジェクトを渡す形にしています。

class LoginPage {
  readonly submit = this.dep.label.toUpperCase();
  constructor(private readonly dep: { label: string }) {}
}
条件結果
1.64.1(Node.js)成功
1.65.0(Node.js)失敗:TypeError: Cannot read properties of undefined (reading 'label')
1.65.0(Bun、--bun あり)失敗:TypeError: undefined is not an object
1.65.0、tsconfig.json に "useDefineForClassFields": false成功(Node.js・Bunとも)
1.65.0、target を ES2020 に下げる成功
1.65.0、初期化をコンストラクターの中へ移す成功

直し方は2通りです。コードを直すなら、フィールドは型だけを宣言し、値はコンストラクターの中で入れます。

class LoginPage {
  readonly submit: Locator;
  constructor(private readonly page: Page) {
    this.submit = page.getByRole('button', { name: 'Submit' });
  }
}

すぐに直せない場合は、tsconfig.json に "useDefineForClassFields": false を書けば1.64までと同じ動きに戻ります。ただし、これは tsc での型チェックやほかのビルドの結果にも影響する設定です。Playwrightの文書は、テストのフォルダーに専用の tsconfig.json を置く構成を勧めています。Playwrightは読み込むファイルごとに最も近い tsconfig.json を使うため、テストのフォルダーの外にあるページオブジェクトには、そのフォルダーの設定が効かない点に注意が必要です。テスト専用の tsconfig.json を分けていない場合は、アプリ側への影響も確かめてください。

デコレーターを使うクラスでは、1.65.0で別の不具合が2件報告されています。"useDefineForClassFields": false のときに静的フィールドを持つクラスが読み込めないもの(#43936)と、! 付きのフィールドにデコレーターを付けると読み込めないもの(#44065)です。どちらも開発版(main)では直っています。#43936の修正は1.65系のブランチにも取り込まれていますが、2026年11月13日の時点で1.65.1はnpmに公開されていません。デコレーターを使っている場合は、1.65.0での読み込みも確かめてください。

Playwright 1.64.1と1.65.0で同じテストを動かした結果。フィールドの初期化子がコンストラクターの引数を読むクラスは、1.64.1では成功し、1.65.0ではNode.jsでもBunでも失敗した。useDefineForClassFieldsをfalseにする、targetをES2020に下げる、初期化をコンストラクターの中へ移す、のいずれでも成功した

test.skip の説明が記録に残るように

同じく1.65から、test.skip・test.fixme・test.fail・test.slow に説明だけを渡せるようになり、その説明がテストの注釈(annotation)に記録されます。

test('upload a file', async ({ page }) => {
  test.skip('Not implemented yet');
});

JSONのレポーターで比べると、1.64.1では注釈が {type: 'skip'} だけで、説明は残りませんでした。1.65.0では description: 'Not implemented yet' が入ります。どちらの版でも、テストはスキップ扱いになりました。スキップしたテストの理由をレポートから集計している場合は、1.65以降で値が入るようになります。

Bunで動かす

1.65から、テストランナーがBunで動くようになりました。リリースノートは、--bun を付けないと bunx playwright test はNode.jsで動くと注意しています。手元(Bun 1.4.4)で、テストの中から実行環境を出力して確かめた結果も同じでした。

npx playwright test                → node v22.23.4
bun x playwright test              → node v22.23.4
bun x --bun playwright test        → bun 1.4.4

リリースノートが挙げる、Bunでの違いは次のとおりです。PlaywrightのCIは、Linux上のBun 1.4.3でテストランナーのテストを動かしているとしています(手元で使ったのは1.4.4です)。

  • ウォッチモードがない。UIモードはファイルの変更で再実行せず、--only-changed はimportをたどらない
  • モジュールの読み込みはBunが行うため、--tsconfig と tsconfig.json のJSXの設定は効かず、独自のESMローダーも使えない
  • スタックトレースに非同期のフレームが入らず、APIの名前にクラス名が付かない(locator.click ではなく click)。ステップの位置・タイトル・エラーの文面が変わる
  • テストのコンソール出力が、トレースとUIモードに入らない

エラーの文面やステップのタイトルが変わるため、失敗の文面で振り分けている仕組みや、スクリーンショットの比較とは別に、レポートの差分を見ている運用には影響が出る可能性があります。Bunへの切り替えは、Node.jsで動く既存の流れを残したまま、別のジョブで試すのが安全です。Bunそのものの採用の判断はBun 1.4の記事で扱いました。

更新の前に確かめること(編集部の提案)

  1. クラスのフィールドの初期化子を探す。 ページオブジェクトやフィクスチャーのクラスで、= this. で始まる初期化子とコンストラクターのパラメータープロパティが同じクラスにあるものを洗い出します。
  2. tsconfig.json の target を確かめる。 ES2022 以降か、指定していない場合は今回の変更が効きます。
  3. 1.65へ上げるプルリクエストで全テストを流す。 自動更新のプルリクエストをマージする前に、失敗がフィールドの初期化によるものかを確かめます。
  4. レポートの集計を見直す。 スキップの理由が入るようになったこと、新しい failures レポーターと onlyFailures オプション(失敗・不安定・中断のテストだけを残す)も、CIのログの見やすさに役立ちます。

前の版の変更点はPlaywright 1.64の記事でまとめています。

確認した範囲

2026年11月13日に、microsoft/playwrightのリリースノート(docs/src/release-notes-js.md、タグ v1.65.0)とGitHubのリリースのページ、テストのAPIの文書(class-test.md)、TypeScriptの設定の文書(test-typescript-js.md)、npmの公開日時、1.65.0に関するissueを確認しました(資料調査)。あわせて、上記の環境で1.64.1と1.65.0に同じテストを入れて動かしました(実機検証)。ブラウザーを使うテスト、Windows・macOSでの動作、UIモードは確かめていません。

公開前のテストの自動化や、サイトの改修とあわせたテストの見直しは、グリームハブの開発・AI・自動化のご相談で承っています。お問い合わせからご相談ください。

参考資料

この記事を共有XFacebook
鈴木 翔

技術の可能性に魅了され、学生時代からプログラミングとデジタルアートの分野に深い関心を持つ

この記事のテーマを、自社の次の一歩へ

Webサイトで、実現したいことから。

使う人の目的、必要な機能、更新の体制を整理し、制作・改善で最初に取り組むことを考えます。

  • サイトの目的
  • 機能と使いやすさ
  • 公開後の運用
Web制作・改善を相談する

構想段階からご相談いただけます。この記事の情報を相談フォームに引き継ぎます。

最新記事をメールで受け取る・Web制作ガイドを読む
無料ダウンロード

Web制作 費用・発注・集客 完全ガイド【2026年版】

費用相場・制作会社の選び方・集客戦略をPDFにまとめました。

The PDF and newsletter emails are currently in Japanese.

メルマガにも登録されます。いつでも解除可能です。