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での読み込みも確かめてください。

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の記事で扱いました。
更新の前に確かめること(編集部の提案)
- クラスのフィールドの初期化子を探す。 ページオブジェクトやフィクスチャーのクラスで、
= this.で始まる初期化子とコンストラクターのパラメータープロパティが同じクラスにあるものを洗い出します。 tsconfig.jsonのtargetを確かめる。ES2022以降か、指定していない場合は今回の変更が効きます。- 1.65へ上げるプルリクエストで全テストを流す。 自動更新のプルリクエストをマージする前に、失敗がフィールドの初期化によるものかを確かめます。
- レポートの集計を見直す。 スキップの理由が入るようになったこと、新しい
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・自動化のご相談で承っています。お問い合わせからご相談ください。









