リリースノート
バージョン 1.55
Codegen
- 自動
toBeVisible()アサーション: Codegen は、一般的な UI 操作に対して自動toBeVisible()アサーションを生成できるようになりました。この機能は Codegen 設定 UI で有効にできます。
破壊的変更
- ⚠️ Chromium 拡張機能マニフェスト v2 のサポートを終了しました。
その他
- Debian 13 "Trixie" のサポートを追加しました。
ブラウザバージョン
- Chromium 140.0.7339.16
- Mozilla Firefox 141.0
- WebKit 26.0
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 139
- Microsoft Edge 139
バージョン 1.54
ハイライト
-
browser_context.cookies() および browser_context.add_cookies() に新しい Cookie プロパティ
partition_keyが追加されました。このプロパティにより、パーティション化された Cookie を保存および復元できます。詳細については、CHIPS MDN の記事 を参照してください。ブラウザによって Cookie のパーティション化のサポートとデフォルトは異なります。 -
複数のコマンドで新しいオプション
--user-data-dir。セッション間で認証などのブラウジング状態を再利用するために、同じユーザーデータディレクトリを指定できます。playwright codegen --user-data-dir=./user-data -
playwright openはテストレコーダーを開かなくなりました。代わりにplaywright codegenを使用してください。
ブラウザバージョン
- Chromium 139.0.7258.5
- Mozilla Firefox 140.0.2
- WebKit 26.0
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 140
- Microsoft Edge 140
バージョン 1.53
トレースビューアーとHTMLレポーターの更新
-
トレースビューアの新しいステップ:
-
ロケーターを記述するための新しいメソッド locator.describe()。トレースビューアで使用されます。
button = page.get_by_test_id("btn-sub").describe("Subscribe button")
button.click() -
python -m playwright install --listで、インストールされているすべてのブラウザ、バージョン、および場所が一覧表示されるようになりました。
ブラウザバージョン
- Chromium 138.0.7204.4
- Mozilla Firefox 139.0
- WebKit 18.5
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 137
- Microsoft Edge 137
バージョン 1.52
ハイライト
-
要素の個々のクラス名を人間工学的にアサートするための新しいメソッド expect(locator).to_contain_class()。
expect(page.get_by_role('listitem', name='Ship v1.52')).to_contain_class('done') -
Aria スナップショット には、厳密なマッチングのための
/childrenとリンクのための/urlという 2 つの新しいプロパティが追加されました。expect(locator).to_match_aria_snapshot("""
- list
- /children: equal
- listitem: Feature A
- listitem:
- link "Feature B":
- /url: "https://playwright.dokyumento.jp"
""")
その他
- api_request.new_context() に、リダイレクトの最大数を制御する新しいオプション max_redirects が追加されました。
破壊的変更
- page.route() のようなメソッドにおける Glob URL パターンは、
?および[]をサポートしなくなりました。代わりに正規表現を使用することをお勧めします。 - メソッド route.continue_() は、
Cookieヘッダーを上書きできなくなりました。Cookieヘッダーが指定されても無視され、Cookie はブラウザの Cookie ストアからロードされます。カスタム Cookie を設定するには、browser_context.add_cookies() を使用してください。 - macOS 13 は非推奨となり、WebKit の更新は受けられなくなります。最新の WebKit の改善を利用し続けるために、より新しい macOS バージョンにアップグレードしてください。
ブラウザバージョン
- Chromium 136.0.7103.25
- Mozilla Firefox 137.0
- WebKit 18.4
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 135
- Microsoft Edge 135
バージョン 1.51
ハイライト
-
browser_context.storage_state() の新しいオプション indexed_db により、IndexedDB のコンテンツを保存および復元できます。Firebase 認証のように、アプリケーションが認証トークンを保存するために IndexedDB API を使用する場合に役立ちます。
認証ガイド に従う例を次に示します。
# Save storage state into the file. Make sure to include IndexedDB.
storage = await context.storage_state(path="state.json", indexed_db=True)
# Create a new context with the saved storage state.
context = await browser.new_context(storage_state="state.json") -
locator.filter() の新しいオプション visible により、表示されている要素のみをマッチングできます。
# Ignore invisible todo items.
todo_items = page.get_by_test_id("todo-item").filter(visible=True)
# Check there are exactly 3 visible ones.
await expect(todo_items).to_have_count(3) -
メソッド page.emulate_media() および browser.new_context() の新しいオプション
contrastにより、prefers-contrastメディア機能をエミュレートできます。 -
新しいオプション fail_on_status_code により、APIRequestContext を介して行われるすべてのフェッチリクエストが、2xx および 3xx 以外のレスポンスコードで例外をスローするようになります。
ブラウザバージョン
- Chromium 134.0.6998.35
- Mozilla Firefox 135.0
- WebKit 18.4
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 133
- Microsoft Edge 133
バージョン 1.50
非同期 Pytest プラグイン
- Playwright の Pytest プラグイン が 非同期フィクスチャ をサポートするようになりました。
その他
- ロケーターが指定された aria errormessage を持つ要素を指していることをアサートするために、メソッド expect(locator).to_have_accessible_error_message() が追加されました。
UI の更新
- Codegen に、aria スナップショットを生成する要素を選択するための新しいボタンが追加されました。
- アクション API 呼び出しと一緒に、追加の詳細(押されたキーなど)がトレースに表示されるようになりました。
- トレースでの
canvasコンテンツの表示はエラーが発生しやすいです。表示はデフォルトで無効になり、Display canvas contentUI 設定で有効にできます。 CallおよびNetworkパネルに、追加の時間情報が表示されるようになりました。
破壊的変更
- expect(locator).to_be_editable() と locator.is_editable() は、ターゲット要素が
<input>、<select>、またはその他の編集可能な要素でない場合に例外をスローするようになりました。
ブラウザバージョン
- Chromium 133.0.6943.16
- Mozilla Firefox 134.0
- WebKit 18.2
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 132
- Microsoft Edge 132
バージョン 1.49
Aria スナップショット
新しいアサーション expect(locator).to_match_aria_snapshot() は、YAML で表現された期待されるアクセシビリティツリーと比較することでページ構造を検証します。
page.goto("https://playwright.dokyumento.jp")
expect(page.locator('body')).to_match_aria_snapshot('''
- banner:
- heading /Playwright enables reliable/ [level=1]
- link "Get started"
- link "Star microsoft/playwright on GitHub"
- main:
- img "Browsers (Chromium, Firefox, WebKit)"
- heading "Any browser • Any platform • One API"
''')
このアサーションは、テストジェネレーター で生成するか、locator.aria_snapshot() を呼び出すことで生成できます。
詳細については、aria スナップショットガイド を参照してください。
トレースグループ
新しいメソッド tracing.group() を使用すると、トレースビューアでアクションを視覚的にグループ化できます。
# All actions between group and group_end
# will be shown in the trace viewer as a group.
page.context.tracing.group("Open Playwright.dev > API")
page.goto("https://playwright.dokyumento.jp/")
page.get_by_role("link", name="API").click()
page.context.tracing.group_end()
破壊的変更: chrome と msedge チャネルが新しいヘッドレスモードに切り替わります
この変更は、playwright.config.ts で以下のチャネルのいずれかを使用している場合に影響します。
chrome,chrome-dev,chrome-beta, またはchrome-canarymsedge,msedge-dev,msedge-beta, またはmsedge-canary
Playwright v1.49 にアップデートした後、テストスイートを実行してください。もし引き続き合格するなら問題ありません。そうでない場合は、スナップショットを更新し、PDF ビューアーと拡張機能に関するテストコードの一部を修正する必要があるでしょう。詳細については、issue #33566 を参照してください。
新しい Chromium ヘッドレスを試す
'chromium' チャネルを使用することで、新しいヘッドレスモードをオプトインできます。公式の Chrome ドキュメント にあるように、
一方、新しいヘッドレスは実際の Chrome ブラウザであり、より本格的で信頼性が高く、より多くの機能を提供します。これにより、高精度のエンドツーエンド Web アプリテストやブラウザ拡張機能テストに適しています。
発生する可能性のある破壊的変更のリストと Chromium ヘッドレスの詳細については、issue #33566 を参照してください。オプトイン後に問題が見られた場合は、イシューを提出してください。
pytest test_login.py --browser-channel chromium
その他
- Ubuntu 20.04 および Debian 11 の WebKit の更新はこれ以上行われません。OS を新しいバージョンに更新することをお勧めします。
- スナップショット内の
<canvas>要素がプレビューを描画するようになりました。 - Python 3.8 はサポートされなくなりました。
ブラウザバージョン
- Chromium 131.0.6778.33
- Mozilla Firefox 132.0
- WebKit 18.2
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 130
- Microsoft Edge 130
バージョン 1.48
WebSocket ルーティング
新しいメソッド page.route_web_socket() と browser_context.route_web_socket() により、ページで開始された WebSocket 接続をインターセプト、変更、モックできるようになりました。以下は、"request" に "response" で応答することで WebSocket 通信をモックする簡単な例です。
def message_handler(ws: WebSocketRoute, message: Union[str, bytes]):
if message == "request":
ws.send("response")
page.route_web_socket("/ws", lambda ws: ws.on_message(
lambda message: message_handler(ws, message)
))
詳細については、WebSocketRoute を参照してください。
UI の更新
- HTML レポートのアノテーションとテスト場所の新しい「コピー」ボタン。
- route.fulfill() のようなルートメソッド呼び出しは、レポートとトレースビューアに表示されなくなりました。代わりにネットワークタブで、どのネットワークリクエストがルーティングされたかを確認できます。
- ネットワークタブのリクエストに新しい「cURL としてコピー」および「fetch としてコピー」ボタン。
その他
- 新しいメソッド page.request_gc() はメモリリークの検出に役立つ場合があります。
- APIRequestContext によって行われたリクエストは、HAR に詳細なタイミングとセキュリティ情報を記録するようになりました。
ブラウザバージョン
- Chromium 130.0.6723.19
- Mozilla Firefox 130.0
- WebKit 18.0
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 129
- Microsoft Edge 129
バージョン 1.47
ネットワークタブの改善
トレースビューアのネットワークタブがいくつか改善されました。
- アセットタイプとURLによるフィルタリング
- クエリ文字列パラメータのより良い表示
- フォントアセットのプレビュー
その他
mcr.microsoft.com/playwright/python:v1.47.0は、Ubuntu 24.04 Noble ベースの Playwright イメージを提供するようになりました。22.04 jammy ベースのイメージを使用するには、代わりにmcr.microsoft.com/playwright/python:v1.47.0-jammyを使用してください。- Playwright Docker イメージの
:latest/:focal/:jammyタグは公開されなくなりました。安定性と再現性を高めるために、特定のバージョンにピン留めしてください。 - TLS クライアント証明書は、ファイルパスの代わりに client_certificates.cert と client_certificates.key をバイトとして渡すことで、メモリから渡すことができるようになりました。
- locator.select_option() の no_wait_after は非推奨になりました。
- GitHub Actions
macos-13で WebKit の WebGL が誤動作するという報告がありました。GitHub Actions をmacos-14にアップグレードすることをお勧めします。
ブラウザバージョン
- Chromium 129.0.6668.29
- Mozilla Firefox 130.0
- WebKit 18.0
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 128
- Microsoft Edge 128
バージョン 1.46
TLS クライアント証明書
Playwright は、TLS クライアント認証で指定されているように、サーバーがそれらを検証できるようにクライアントサイド証明書を提供できるようになりました。
browser.new_context() および api_request.new_context() のパラメーターとしてクライアント証明書を提供できます。次のスニペットは、https://example.com のクライアント証明書を設定します。
context = browser.new_context(
client_certificates=[
{
"origin": "https://example.com",
"certPath": "client-certificates/cert.pem",
"keyPath": "client-certificates/key.pem",
}
],
)
トレースビューアの更新
- テキストアタッチメントの内容がアタッチメントペインにインラインでレンダリングされるようになりました。
- route.continue_() のようなルーティングアクションを表示/非表示にする新しい設定。
- リクエストメソッドとステータスがネットワーク詳細タブに表示されます。
- ソースファイルの場所をクリップボードにコピーする新しいボタン。
- メタデータペインに
base_urlが表示されるようになりました。
その他
- api_request_context.fetch() に新しい
maxRetriesオプションが追加され、ECONNRESETネットワークエラー時に再試行するようになりました。
ブラウザバージョン
- Chromium 128.0.6613.18
- Mozilla Firefox 128.0
- WebKit 18.0
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 127
- Microsoft Edge 127
バージョン 1.45
時計
新しい Clock API を利用することで、テスト内の時間を操作および制御し、時間関連の動作を検証できます。この API は、多くの一般的なシナリオをカバーしています。これには以下が含まれます。
- 定義済みの時間でのテスト。
- 一貫した時間とタイマーの維持。
- 非活動の監視。
- 手動での時間経過。
# Initialize clock with some time before the test time and let the page load
# naturally. `Date.now` will progress as the timers fire.
page.clock.install(time=datetime.datetime(2024, 2, 2, 8, 0, 0))
page.goto("https://:3333")
# Pretend that the user closed the laptop lid and opened it again at 10am.
# Pause the time once reached that point.
page.clock.pause_at(datetime.datetime(2024, 2, 2, 10, 0, 0))
# Assert the page state.
expect(page.get_by_test_id("current-time")).to_have_text("2/2/2024, 10:00:00 AM")
# Close the laptop lid again and open it at 10:30am.
page.clock.fast_forward("30:00")
expect(page.get_by_test_id("current-time")).to_have_text("2/2/2024, 10:30:00 AM")
詳細については、クロックガイド を参照してください。
その他
-
メソッド locator.set_input_files() が、
<input type=file webkitdirectory>要素のディレクトリのアップロードをサポートするようになりました。page.get_by_label("Upload directory").set_input_files('mydir') -
locator.click() や locator.press() のような複数のメソッドが、
ControlOrMeta修飾キーをサポートするようになりました。このキーは macOS ではMetaに、Windows と Linux ではControlにマッピングされます。# Press the common keyboard shortcut Control+S or Meta+S to trigger a "Save" operation.
page.keyboard.press("ControlOrMeta+S") -
api_request.new_context() に新しいプロパティ
httpCredentials.sendが追加され、Authorizationヘッダーを常に送信するか、または401 Unauthorizedに応答してのみ送信するかを選択できるようになりました。 -
Playwright は現在、Ubuntu 24.04 で Chromium、Firefox、および WebKit をサポートしています。
-
v1.45 は、macOS 12 Monterey 向け WebKit アップデートを受け取る最後のリリースです。最新の WebKit を引き続き使用するには、macOS を更新してください。
ブラウザバージョン
- Chromium 127.0.6533.5
- Mozilla Firefox 127.0
- WebKit 17.4
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 126
- Microsoft Edge 126
バージョン 1.44
新しいAPI
アクセシビリティアサーション
-
expect(locator).to_have_accessible_name() は、要素が指定されたアクセシブル名を持っているかをチェックします。
locator = page.get_by_role("button")
expect(locator).to_have_accessible_name("Submit") -
expect(locator).to_have_accessible_description() は、要素が指定されたアクセシブルな説明を持っているかをチェックします。
locator = page.get_by_role("button")
expect(locator).to_have_accessible_description("Upload a photo") -
expect(locator).to_have_role() は、要素が指定された ARIA ロールを持っているかをチェックします。
locator = page.get_by_test_id("save-button")
expect(locator).to_have_role("button")
ロケータハンドラ
- page.add_locator_handler() で追加されたハンドラーが実行された後、Playwright はハンドラーをトリガーしたオーバーレイが非表示になるまで待機するようになりました。この動作は、新しい
no_wait_afterオプションでオプトアウトできます。 - page.add_locator_handler() の新しい
timesオプションを使用して、ハンドラーが実行される最大回数を指定できます。 - page.add_locator_handler() のハンドラーが、引数としてロケーターを受け入れるようになりました。
- 以前に追加されたロケーターハンドラーを削除するための新しいメソッド page.remove_locator_handler()。
locator = page.get_by_text("This interstitial covers the button")
page.add_locator_handler(locator, lambda overlay: overlay.locator("#close").click(), times=3, no_wait_after=True)
# Run your tests that can be interrupted by the overlay.
# ...
page.remove_locator_handler(locator)
その他のオプション
- expect(page).to_have_url() が
ignore_caseオプション をサポートするようになりました。
ブラウザバージョン
- Chromium 125.0.6422.14
- Mozilla Firefox 125.0.1
- WebKit 17.4
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 124
- Microsoft Edge 124
バージョン 1.43
新しいAPI
-
メソッド browser_context.clear_cookies() が、一部の Cookie のみを削除するためのフィルターをサポートするようになりました。
# Clear all cookies.
context.clear_cookies()
# New: clear cookies with a particular name.
context.clear_cookies(name="session-id")
# New: clear cookies for a particular domain.
context.clear_cookies(domain="my-origin.com") -
新しいメソッド locator.content_frame は、Locator オブジェクトを FrameLocator に変換します。これは、どこかで取得した Locator オブジェクトがあり、後でフレーム内のコンテンツと対話したい場合に役立ちます。
locator = page.locator("iframe[name='embedded']")
# ...
frame_locator = locator.content_frame
frame_locator.getByRole("button").click() -
新しいメソッド frame_locator.owner は、FrameLocator オブジェクトを Locator に変換します。これは、どこかで取得した FrameLocator オブジェクトがあり、後で
iframe要素と対話したい場合に役立ちます。frame_locator = page.frame_locator("iframe[name='embedded']")
# ...
locator = frame_locator.owner
expect(locator).to_be_visible() -
Conda ビルドが macOS-arm64 および Linux-arm64 向けに公開されるようになりました。
ブラウザバージョン
- Chromium 124.0.6367.8
- Mozilla Firefox 124.0
- WebKit 17.4
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 123
- Microsoft Edge 123
バージョン 1.42
新しいロケーターハンドラー
新しいメソッド page.add_locator_handler() は、指定された要素が表示され、Playwright アクションをブロックする可能性がある場合に呼び出されるコールバックを登録します。コールバックはオーバーレイを取り除くことができます。以下は、Cookie ダイアログが表示されたときに閉じる例です。
# Setup the handler.
page.add_locator_handler(
page.get_by_role("heading", name="Hej! You are in control of your cookies."),
lambda: page.get_by_role("button", name="Accept all").click(),
)
# Write the test as usual.
page.goto("https://www.ikea.com/")
page.get_by_role("link", name="Collection of blue and white").click()
expect(page.get_by_role("heading", name="Light and easy")).to_be_visible()
新しいAPI
- page.pdf() は、tagged と outline という 2 つの新しいオプションを受け入れます。
アナウンス
- ⚠️ Ubuntu 18 はサポートされなくなりました。
ブラウザバージョン
- Chromium 123.0.6312.4
- Mozilla Firefox 123.0
- WebKit 17.4
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 122
- Microsoft Edge 123
バージョン 1.41
新しいAPI
- 新しいメソッド page.unroute_all() は、page.route() および page.route_from_har() で登録されたすべてのルートを削除します。オプションで、進行中のルートの完了を待機したり、それらからのエラーを無視したりできます。
- 新しいメソッド browser_context.unroute_all() は、browser_context.route() および browser_context.route_from_har() で登録されたすべてのルートを削除します。オプションで、進行中のルートの完了を待機したり、それらからのエラーを無視したりできます。
- page.screenshot() の新しいオプション style と、locator.screenshot() の新しいオプション style により、スクリーンショットを撮る前にページにカスタム CSS を追加できるようになりました。
ブラウザバージョン
- Chromium 121.0.6167.57
- Mozilla Firefox 121.0
- WebKit 17.4
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 120
- Microsoft Edge 120
バージョン 1.40
テストジェネレータの更新
アサーションを生成する新しいツール
- 「可視性をアサート」ツールは expect(locator).to_be_visible() を生成します。
- 「値をアサート」ツールは expect(locator).to_have_value() を生成します。
- 「テキストをアサート」ツールは expect(locator).to_contain_text() を生成します。
以下は、アサーション付きで生成されたテストの例です。
from playwright.sync_api import Page, expect
def test_example(page: Page) -> None:
page.goto("https://playwright.dokyumento.jp/")
page.get_by_role("link", name="Get started").click()
expect(page.get_by_label("Breadcrumbs").get_by_role("list")).to_contain_text("Installation")
expect(page.get_by_label("Search")).to_be_visible()
page.get_by_label("Search").click()
page.get_by_placeholder("Search docs").fill("locator")
expect(page.get_by_placeholder("Search docs")).to_have_value("locator");
新しいAPI
- page.close() の reason オプション、browser_context.close() の reason オプション、および browser.close() の reason オプション。閉鎖によって中断されたすべての操作に対して、閉鎖理由が報告されます。
- browser_type.launch_persistent_context() の firefox_user_prefs オプション。
その他の変更
- メソッド download.path() は、失敗したダウンロードおよびキャンセルされたダウンロードに対してエラーをスローするようになりました。
ブラウザバージョン
- Chromium 120.0.6099.28
- Mozilla Firefox 119.0
- WebKit 17.4
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 119
- Microsoft Edge 119
バージョン 1.39
エバーグリーンブラウザの更新。
ブラウザバージョン
- Chromium 119.0.6045.9
- Mozilla Firefox 118.0.1
- WebKit 17.4
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 118
- Microsoft Edge 118
バージョン 1.38
トレースビューアの更新
- 時間範囲のズーム。
- ネットワークパネルの再設計。
新しいAPI
非推奨
- 以下のメソッドは非推奨になりました: page.type()、frame.type()、locator.type()、および element_handle.type()。代わりに、はるかに高速な locator.fill() を使用してください。ページに特別なキーボード処理があり、キーを一つずつ押す必要がある場合にのみ、locator.press_sequentially() を使用してください。
ブラウザバージョン
- Chromium 117.0.5938.62
- Mozilla Firefox 117.0
- WebKit 17.0
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 116
- Microsoft Edge 116
バージョン 1.37
ハイライト
- 新しいコマンドラインフラグ --full-page-screenshot を使用すると、失敗時にページ全体のスクリーンショットを撮ることができます。
- browser_context_args マーカーを使用することで、単一のテストに対してコンテキストオプションをオーバーライドできるようになりました。
pytest-playwrightが Anaconda でも公開されるようになりました。
📚 Debian 12 Bookworm のサポート
Playwright は現在、x86_64 および arm64 の両方で Debian 12 Bookworm を Chromium、Firefox、および WebKit でサポートしています。問題が発生した場合はお知らせください。
Linux のサポートは次のようになります。
| Ubuntu 20.04 | Ubuntu 22.04 | Debian 11 | Debian 12 | |
|---|---|---|---|---|
| Chromium | ✅ | ✅ | ✅ | ✅ |
| WebKit | ✅ | ✅ | ✅ | ✅ |
| Firefox | ✅ | ✅ | ✅ | ✅ |
ブラウザバージョン
- Chromium 116.0.5845.82
- Mozilla Firefox 115.0
- WebKit 17.0
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 115
- Microsoft Edge 115
バージョン 1.36
🏝️ 夏のメンテナンスリリース。
ブラウザバージョン
- Chromium 115.0.5790.75
- Mozilla Firefox 115.0
- WebKit 17.0
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 114
- Microsoft Edge 114
バージョン 1.35
ハイライト
-
メソッド page.screenshot() および locator.screenshot() の新しいオプション
mask_colorにより、デフォルトのマスキング色を変更できます。 -
ブラウザバイナリをアンインストールする新しい
uninstallCLI コマンド。$ playwright uninstall # remove browsers installed by this installation
$ playwright uninstall --all # remove all ever-install Playwright browsers
ブラウザバージョン
- Chromium 115.0.5790.13
- Mozilla Firefox 113.0
- WebKit 16.4
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 114
- Microsoft Edge 114
バージョン 1.34
ハイライト
-
新しい locator.and_() により、両方のロケーターにマッチするロケーターを作成できます。
button = page.get_by_role("button").and_(page.get_by_title("Subscribe")) -
新しいイベント browser_context.on("console") および browser_context.on("dialog") により、指定されたブラウザコンテキストからの任意のページからのダイアログおよびコンソールメッセージを購読できるようになりました。イベントソースを特定するには、新しいメソッド console_message.page および dialog.page を使用してください。
ブラウザバージョン
- Chromium 114.0.5735.26
- Mozilla Firefox 113.0
- WebKit 16.4
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 113
- Microsoft Edge 113
バージョン 1.33
ロケータの更新
-
locator.or_() を使用して、2 つのロケーターのいずれかに一致するロケーターを作成します。「新しいメール」ボタンをクリックしたいが、セキュリティ設定ダイアログが表示されることがあるシナリオを考えてみましょう。この場合、「新しいメール」ボタンまたはダイアログのいずれかを待ち、それに応じてアクションを実行できます。
new_email = page.get_by_role("button", name="New email")
dialog = page.get_by_text("Confirm security settings")
expect(new_email.or_(dialog)).is_visible()
if (dialog.is_visible()):
page.get_by_role("button", name="Dismiss").click()
new_email.click() -
locator.filter() の新しいオプション has_not と has_not_text を使用して、特定の条件に**一致しない**要素を見つけます。
row_locator = page.locator("tr")
row_locator.filter(has_not_text="text in column 1").filter(
has_not=page.get_by_role("button", name="column 2 button")
).screenshot() -
新しいWebファーストアサーション expect(locator).to_be_attached() を使用して、要素がページのDOMに存在することを確認します。expect(locator).to_be_visible() は要素がアタッチされ、かつ表示されていることを確認するものであり、混同しないでください。
新しいAPI
- locator.or_()
- locator.filter() の新しいオプション has_not。
- locator.filter() の新しいオプション has_not_text。
- expect(locator).to_be_attached()
- route.fetch() の新しいオプション timeout。
⚠️ 破壊的変更
mcr.microsoft.com/playwright/python:v1.33.0は、Ubuntu Jammy ベースの Playwright イメージを提供するようになりました。focal ベースのイメージを使用するには、代わりにmcr.microsoft.com/playwright/python:v1.33.0-focalを使用してください。
ブラウザバージョン
- Chromium 113.0.5672.53
- Mozilla Firefox 112.0
- WebKit 16.4
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 112
- Microsoft Edge 112
バージョン 1.32
新しいAPI
- カスタム expect メッセージについては、テストアサーションのドキュメント を参照してください。
- page.route_from_har() および browser_context.route_from_har() の新しいオプション update_mode および update_content。
- 既存のロケーターオブジェクトの連鎖については、ロケーターのドキュメント を参照してください。
- メソッド tracing.start_chunk() の新しいオプション name。
ブラウザバージョン
- Chromium 112.0.5615.29
- Mozilla Firefox 111.0
- WebKit 16.4
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 111
- Microsoft Edge 111
バージョン 1.31
新しいAPI
-
新しいアサーション expect(locator).to_be_in_viewport() は、Intersection Observer API に従って、ロケーターがビューポートと交差する要素を指していることを保証します。
from playwright.sync_api import expect
locator = page.get_by_role("button")
# Make sure at least some part of element intersects viewport.
expect(locator).to_be_in_viewport()
# Make sure element is fully outside of viewport.
expect(locator).not_to_be_in_viewport()
# Make sure that at least half of the element intersects viewport.
expect(locator).to_be_in_viewport(ratio=0.5)
その他
- トレースビューアーのDOMスナップショットが別のウィンドウで開けるようになりました。
- メソッド route.fetch() の新しいオプション max_redirects。
- Playwright は Debian 11 arm64 をサポートするようになりました。
- 公式の Docker イメージ が Node 16 の代わりに Node 18 を含むようになりました。
ブラウザのバージョン
- Chromium 111.0.5563.19
- Mozilla Firefox 109.0
- WebKit 16.4
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 110
- Microsoft Edge 110
バージョン 1.30
ブラウザのバージョン
- Chromium 110.0.5481.38
- Mozilla Firefox 108.0.2
- WebKit 16.4
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 109
- Microsoft Edge 109
バージョン 1.29
新しいAPI
-
新しいメソッド route.fetch() と route.fulfill() の新しいオプション
json。def handle_route(route: Route):
# Fetch original settings.
response = route.fetch()
# Force settings theme to a predefined value.
json = response.json()
json["theme"] = "Solorized"
# Fulfill with modified data.
route.fulfill(json=json)
page.route("**/api/settings", handle_route) -
すべてのマッチする要素を反復処理するための新しいメソッド locator.all()。
# Check all checkboxes!
checkboxes = page.get_by_role("checkbox")
for checkbox in checkboxes.all():
checkbox.check() -
locator.select_option() が値またはラベルでマッチするようになりました。
<select multiple>
<option value="red">Red</option>
<option value="green">Green</option>
<option value="blue">Blue</option>
</select>element.select_option("Red")
その他
- メソッド route.continue_() の
postDataオプションが Serializable 値をサポートするようになりました。
ブラウザのバージョン
- Chromium 109.0.5414.46
- Mozilla Firefox 107.0
- WebKit 16.4
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 108
- Microsoft Edge 108
バージョン 1.28
Playwright ツール
- CodeGenでのライブロケーター。「探索」ツールを使用して、ページ上の任意の要素のロケーターを生成します。

新しいAPI
ブラウザのバージョン
- Chromium 108.0.5359.29
- Mozilla Firefox 106.0
- WebKit 16.4
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 107
- Microsoft Edge 107
バージョン 1.27
ロケーター
これらの新しいAPIにより、ロケーターの記述が楽しくなりました
- テキストコンテンツで要素を特定するための page.get_by_text()。
- ARIA ロール、ARIA 属性、および アクセシブル名 で要素を特定するための page.get_by_role()。
- 関連するラベルのテキストでフォームコントロールを特定するための page.get_by_label()。
data-testid属性(他の属性も設定可能)に基づいて要素を特定するための page.get_by_test_id()。- プレースホルダーで入力を特定するための page.get_by_placeholder()。
- 通常は画像である要素をその代替テキストで特定するための page.get_by_alt_text()。
- 要素をそのタイトルで特定するための page.get_by_title()。
page.get_by_label("User Name").fill("John")
page.get_by_label("Password").fill("secret-password")
page.get_by_role("button", name="Sign in").click()
expect(page.get_by_text("Welcome, John!")).to_be_visible()
上記のすべてのメソッドは、Locator、FrameLocator、および Frame クラスでも利用できます。
その他のハイライト
- v1.25 で発表されたように、Ubuntu 18 は2022年12月以降サポートされません。それに加えて、次のPlaywrightリリースからはUbuntu 18でのWebKitの更新はありません。
動作の変更
-
expect(locator).to_have_attribute() は、空の値では属性の欠如に一致しなくなりました。たとえば、次のスニペットは、
buttonにdisabled属性が**ない**場合に成功します。expect(page.get_by_role("button")).to_have_attribute("disabled", "")
ブラウザのバージョン
- Chromium 107.0.5304.18
- Mozilla Firefox 105.0.1
- WebKit 16.0
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 106
- Microsoft Edge 106
バージョン 1.26
アサーション
- expect(locator).to_be_enabled() の新しいオプション
enabled。 - expect(locator).to_have_text() は、オープンシャドウルーツを貫通するようになりました。
- expect(locator).to_be_editable() の新しいオプション
editable。 - expect(locator).to_be_visible() の新しいオプション
visible。
その他のハイライト
- api_request_context.get() およびその他のメソッドの新しいオプション
max_redirectsで、リダイレクト数を制限します。 - Python 3.11 がサポートされるようになりました。
動作の変更
Playwright API の多くはすでに wait_until: "domcontentloaded" オプションをサポートしています。たとえば、
page.goto("https://playwright.dokyumento.jp", wait_until="domcontentloaded")
1.26以前では、これはすべてのiframeが DOMContentLoaded イベントを発火するまで待機していました。
Web 仕様に合わせるため、'domcontentloaded' の値はターゲットフレームが 'DOMContentLoaded' イベントを発生させるのを待つだけです。すべての iframe を待つには wait_until="load" を使用してください。
ブラウザのバージョン
- Chromium 106.0.5249.30
- Mozilla Firefox 104.0
- WebKit 16.0
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 105
- Microsoft Edge 105
バージョン 1.25
お知らせ
- 🎁 Ubuntu 22.04 Jammy Jellyfish Docker イメージ
mcr.microsoft.com/playwright/python:v1.34.0-jammyを提供するようになりました。 - 🪦 これは macOS 10.15 サポートの最後のリリースです (1.21 で非推奨)。
- ⚠️ Ubuntu 18 は非推奨となり、2022年12月以降はサポートされません。
ブラウザのバージョン
- Chromium 105.0.5195.19
- Mozilla Firefox 103.0
- WebKit 16.0
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 104
- Microsoft Edge 104
バージョン 1.24
🐂 Debian 11 Bullseye のサポート
Playwright は Chromium、Firefox、WebKit の x86_64 で Debian 11 Bullseye をサポートするようになりました。何か問題があればお知らせください!
Linux のサポートは次のようになります。
| | Ubuntu 20.04 | Ubuntu 22.04 | Debian 11 | :--- | :---: | :---: | :---: | | Chromium | ✅ | ✅ | ✅ | | WebKit | ✅ | ✅ | ✅ | | Firefox | ✅ | ✅ | ✅ |
新しい入門ドキュメント
私たちの「はじめてのPlaywright」ドキュメントを、よりエンドツーエンドテストに焦点を当てるように書き直しました。playwright.devでご確認ください。
バージョン 1.23
ネットワークリプレイ
HARファイルにネットワークトラフィックを記録し、そのトラフィックをテストで再利用できるようになりました。
HARファイルにネットワークを記録するには
npx playwright open --save-har=github.har.zip https://github.com/microsoft
または、HARをプログラムで記録することもできます。
- 同期
- 非同期
context = browser.new_context(record_har_path="github.har.zip")
# ... do stuff ...
context.close()
context = await browser.new_context(record_har_path="github.har.zip")
# ... do stuff ...
await context.close()
新しいメソッド page.route_from_har() または browser_context.route_from_har() を使用して、HAR ファイルから一致するレスポンスを提供できるようになりました。
- 同期
- 非同期
context.route_from_har("github.har.zip")
await context.route_from_har("github.har.zip")
詳細については、ドキュメント を参照してください。
高度なルーティング
route.fallback() を使用して、ルーティングを他のハンドラーに委譲できるようになりました。
次の例を考えてみましょう。
- 同期
- 非同期
# Remove a header from all requests
def remove_header_handler(route: Route) -> None:
headers = route.request.all_headers()
if "if-none-match" in headers:
del headers["if-none-match"]
route.fallback(headers=headers)
page.route("**/*", remove_header_handler)
# Abort all images
def abort_images_handler(route: Route) -> None:
if route.request.resource_type == "image":
route.abort()
else:
route.fallback()
page.route("**/*", abort_images_handler)
# Remove a header from all requests
async def remove_header_handler(route: Route) -> None:
headers = await route.request.all_headers()
if "if-none-match" in headers:
del headers["if-none-match"]
await route.fallback(headers=headers)
await page.route("**/*", remove_header_handler)
# Abort all images
async def abort_images_handler(route: Route) -> None:
if route.request.resource_type == "image":
await route.abort()
else:
await route.fallback()
await page.route("**/*", abort_images_handler)
新しいメソッド page.route_from_har() および browser_context.route_from_har() もルーティングに参加し、委譲される可能性があることに注意してください。
Web-Firstアサーションの更新
<select multiple>要素の選択されたすべての値をアサートする新しいメソッド expect(locator).to_have_values()。- メソッド expect(locator).to_contain_text() と expect(locator).to_have_text() が
ignore_caseオプションを受け入れるようになりました。
その他
-
Service Worker が邪魔になる場合は、新しいコンテキストオプション
service_workersを使用して簡単に無効化できます。- 同期
- 非同期
context = browser.new_context(service_workers="block")
page = context.new_page()context = await browser.new_context(service_workers="block")
page = await context.new_page() -
recordHarコンテキストオプションに.zipパスを使用すると、結果の HAR が自動的に圧縮されます。- 同期
- 非同期
context = browser.new_context(record_har_path="github.har.zip")context = await browser.new_context(record_har_path="github.har.zip") -
HARを手動で編集する場合は、リプレイに不可欠な情報のみを記録する
"minimal"HAR記録モードの使用を検討してください。- 同期
- 非同期
context = browser.new_context(record_har_mode="minimal", record_har_path="har.har")context = await browser.new_context(record_har_mode="minimal", record_har_path="har.har") -
Playwright が Ubuntu 22 amd64 および Ubuntu 22 arm64 で動作するようになりました。
バージョン 1.22
ハイライト
-
ARIAロール、ARIA属性、およびアクセシブルネームによって要素を選択できるロールセレクター。
# Click a button with accessible name "log in"
page.locator("role=button[name='log in']").click()詳細については、ドキュメント を参照してください。
-
既存のロケーターをフィルタリングするための新しい locator.filter() API。
buttons = page.locator("role=button")
# ...
submit_button = buttons.filter(has_text="Submit")
submit_button.click() -
Codegen が Pytest テストの生成をサポートするようになりました。

バージョン 1.21
ハイライト
-
ARIAロール、ARIA属性、およびアクセシブルネームによって要素を選択できる新しいロールセレクター。
- 同期
- 非同期
# Click a button with accessible name "log in"
page.locator("role=button[name='log in']").click()# Click a button with accessible name "log in"
await page.locator("role=button[name='log in']").click()詳細については、ドキュメント を参照してください。
-
page.screenshot() の新しい
scaleオプションで、より小さいサイズのスクリーンショットを生成できます。 -
page.screenshot() の新しい
caretオプションで、テキストカーソルを制御できます。デフォルトは"hide"です。
動作の変更
mcr.microsoft.com/playwrightDocker イメージには Python が含まれなくなりました。Python がプリインストールされた Playwright 対応 Docker イメージとして、mcr.microsoft.com/playwright/pythonを使用してください。- Playwright は、locator.set_input_files() API を介した大容量ファイル(数百MB)のアップロードをサポートするようになりました。
ブラウザのバージョン
- Chromium 101.0.4951.26
- Mozilla Firefox 98.0.2
- WebKit 15.4
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 100
- Microsoft Edge 100
バージョン 1.20
ハイライト
- メソッド page.screenshot()、locator.screenshot()、および element_handle.screenshot() の新しいオプション。
- オプション
animations: "disabled"は、すべての CSS アニメーションとトランジションを一貫した状態に巻き戻します。 - オプション
mask: Locator[]は、指定された要素をマスクし、ピンクの#FF00FFボックスでオーバーレイします。
- オプション
- トレースビューア が API テストリクエスト を表示するようになりました。
- locator.highlight() は、要素を視覚的に表示してデバッグを容易にします。
お知らせ
- 専用の Python Docker イメージ
mcr.microsoft.com/playwright/pythonを提供するようになりました。Python を使用する場合は、これに切り替えてください。今回のリリースが、私たちの JavaScriptmcr.microsoft.com/playwrightDocker イメージに Python を含める最後のリリースとなります。 - v1.20 は、macOS 10.15 Catalina 用の WebKit 更新を受け取る最後のリリースです。最新かつ最高の WebKit を使い続けるには、macOS を更新してください!
ブラウザのバージョン
- Chromium 101.0.4921.0
- Mozilla Firefox 97.0.1
- WebKit 15.4
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 99
- Microsoft Edge 99
バージョン 1.19
ハイライト
-
Locator は、内部に別のロケーターが含まれていることを確認する
hasオプションをサポートするようになりました。- 同期
- 非同期
page.locator("article", has=page.locator(".highlight")).click()await page.locator("article", has=page.locator(".highlight")).click()詳細については、ロケーターのドキュメント を参照してください。
-
新しい locator.page。
-
page.screenshot() および locator.screenshot() が点滅するキャレットを自動的に隠すようになりました。
-
Playwright Codegen がロケーターとフレームロケーターを生成するようになりました。
ブラウザのバージョン
- Chromium 100.0.4863.0
- Mozilla Firefox 96.0.1
- WebKit 15.4
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 98
- Microsoft Edge 98
バージョン 1.18
APIテスト
Playwright for Python 1.18 では、新しい API テスト が導入され、Python から直接サーバーにリクエストを送信できるようになりました。これで、
- サーバーAPIをテストする
- テストでウェブアプリケーションにアクセスする前にサーバー側の状態を準備する
- ブラウザでいくつかのアクションを実行した後にサーバー側の事後条件を検証する
Playwright のページに代わってリクエストを行うには、**新しい page.request API** を使用してください。
- 同期
- 非同期
# Do a GET request on behalf of page
res = page.request.get("http://example.com/foo.json")
# Do a GET request on behalf of page
res = await page.request.get("http://example.com/foo.json")
詳細については、ドキュメント を参照してください。
Webファーストアサーション
Playwright for Python 1.18 では、Webファーストアサーションが導入されました。
次の例を考えてみましょう。
- 同期
- 非同期
from playwright.sync_api import Page, expect
def test_status_becomes_submitted(page: Page) -> None:
# ..
page.locator("#submit-button").click()
expect(page.locator(".status")).to_have_text("Submitted")
from playwright.async_api import Page, expect
async def test_status_becomes_submitted(page: Page) -> None:
# ..
await page.locator("#submit-button").click()
await expect(page.locator(".status")).to_have_text("Submitted")
Playwright は、選択子 .status を持つノードを再テストし、取得されたノードが "Submitted" テキストを持つまで続けます。このノードは、条件が満たされるかタイムアウトに達するまで、繰り返し取得およびチェックされます。このタイムアウトはオプションとして渡すことができます。
詳細については、ドキュメント を参照してください。
ロケーターの改善
-
各ロケーターは、含むテキストでオプションでフィルタリングできるようになりました。
- 同期
- 非同期
page.locator("li", has_text="my item").locator("button").click()await page.locator("li", has_text="my item").locator("button").click()詳細については、ロケーターのドキュメント を参照してください。
新しいAPIと変更点
accept_downloadsオプションのデフォルトがTrueになりました。- ソースをトレースに埋め込むための
sourcesオプション。
ブラウザのバージョン
- Chromium 99.0.4812.0
- Mozilla Firefox 95.0
- WebKit 15.4
このバージョンは以下の安定版チャネルでもテストされました
- Google Chrome 97
- Microsoft Edge 97
バージョン 1.17
フレームロケーター
Playwright 1.17 では、フレームロケーター が導入されました。これはページ上の iframe へのロケーターです。フレームロケーターは、iframe を取得し、その iframe 内の要素を見つけるのに十分なロジックをキャプチャします。フレームロケーターはデフォルトで厳密であり、iframe が表示されるのを待ち、Web ファーストアサーションで使用できます。

フレームロケーターは、page.frame_locator() または locator.frame_locator() メソッドのいずれかで作成できます。
locator = page.frame_locator("my-frame").locator("text=Submit")
locator.click()
詳細については、ドキュメント を参照してください。
トレースビューアーの更新
Playwright Trace Viewer が https://trace.playwright.dev でオンラインで利用可能になりました!trace.zip ファイルをドラッグアンドドロップするだけで、その内容を検査できます。
注: トレースファイルはどこにもアップロードされません。trace.playwright.dev は、トレースをローカルで処理するプログレッシブウェブアプリケーションです。
- Playwright Test のトレースにデフォルトでソースが含まれるようになりました (トレースオプションでオフにできます)。
- Trace Viewer にテスト名が表示されるようになりました。
- ブラウザの詳細を含む新しいトレースメタデータタブ
- スナップショットにURLバーが追加されました

HTML レポートの更新
- HTML レポートが動的フィルタリングをサポートするようになりました。
- レポートは単一の静的HTMLファイルとなり、EメールやSlackの添付ファイルとして送信できます。

Ubuntu ARM64 のサポートなど
-
Playwright は Ubuntu 20.04 ARM64 をサポートするようになりました。Apple M1 や Raspberry Pi の Docker 内で Playwright テストを実行できるようになりました。
-
Playwright を使用して Linux に安定版の Edge をインストールできるようになりました。
npx playwright install msedge
新しいAPI
バージョン 1.16
🎭 Playwright ライブラリ
locator.wait_for
指定された状態の単一の要素に解決されるロケーターを待機します。デフォルトは state: 'visible' です。
特にリストを扱う場合に便利です。
order_sent = page.locator("#order-sent")
order_sent.wait_for()
locator.wait_for() の詳細についてはこちらをご覧ください。
Arm64 の Docker サポート
Playwright Docker イメージが Arm64 向けに公開され、Apple Silicon で使用できるようになりました。
Docker 統合 の詳細については、こちらをご覧ください。
🎭 Playwright Trace Viewer
npx playwright show-traceでトレースビューアを実行し、トレースファイルをトレースビューア PWA にドロップします。- アクションターゲットの視覚的帰属の改善
トレースビューア の詳細については、こちらをご覧ください。
ブラウザのバージョン
- Chromium 97.0.4666.0
- Mozilla Firefox 93.0
- WebKit 15.4
このバージョンの Playwright は、以下の安定版チャンネルでもテストされています。
- Google Chrome 94
- Microsoft Edge 94
バージョン 1.15
🖱️ マウスホイール
mouse.wheel() を使用することで、垂直方向または水平方向にスクロールできるようになりました。
📜 新しいヘッダーAPI
以前は、応答の複数のヘッダー値を取得することはできませんでした。これが可能になり、追加のヘルパー関数が利用できるようになりました。
- request.all_headers()
- request.headers_array()
- request.header_value()
- response.all_headers()
- response.headers_array()
- response.header_value()
- response.header_values()
🌈 Forced-Colors エミュレーション
browser.new_context() に渡すか、page.emulate_media() を呼び出すことで、forced-colors CSS メディア機能をエミュレートできるようになりました。
新しいAPI
- page.route() が、このルートが一致する回数を指定する新しい
timesオプションを受け入れるようになりました。 - チェックボックスのチェック状態を設定するために、page.set_checked() と locator.set_checked() が導入されました。
- request.sizes() は、指定された HTTP リクエストのリソースサイズ情報を返します。
- tracing.start_chunk() - 新しいトレースチャンクを開始します。
- tracing.stop_chunk() - 新しいトレースチャンクを停止します。
ブラウザのバージョン
- Chromium 96.0.4641.0
- Mozilla Firefox 92.0
- WebKit 15.0
バージョン 1.14
⚡️ 新しい「厳密」モード
セレクタの曖昧さは、自動化テストにおける一般的な問題です。「厳密」モードは、セレクタが単一の要素を指していることを保証し、そうでなければ例外をスローします。
アクション呼び出しに strict=true を渡してオプトインします。
# This will throw if you have more than one button!
page.click("button", strict=True)
📍 新しい Locators API
ロケーターは、ページ上の要素のビューを表します。特定の時点で要素を取得するのに十分なロジックをキャプチャします。
Locator と ElementHandle の違いは、後者が特定の要素を指すのに対し、Locator はその要素を取得する方法のロジックをキャプチャすることです。
また、ロケーターはデフォルトで「厳密」です!
locator = page.locator("button")
locator.click()
詳細については、ドキュメント を参照してください。
🧩 試験的な React および Vue セレクターエンジン
React および Vue セレクタは、コンポーネント名やプロパティ値で要素を選択できます。構文は 属性セレクタ に非常に似ており、すべての属性セレクタ演算子をサポートしています。
page.locator("_react=SubmitButton[enabled=true]").click()
page.locator("_vue=submit-button[enabled=true]").click()
詳細については、React セレクターのドキュメント と Vue セレクターのドキュメント を参照してください。
✨ 新しい nth および visible セレクターエンジン
nthセレクターエンジンは:nth-match疑似クラスと同等ですが、他のセレクターエンジンと組み合わせることができます。visibleセレクターエンジンは:visible疑似クラスと同等ですが、他のセレクターエンジンと組み合わせることができます。
# select the first button among all buttons
button.click("button >> nth=0")
# or if you are using locators, you can use first, nth() and last
page.locator("button").first.click()
# click a visible button
button.click("button >> visible=true")
ブラウザのバージョン
- Chromium 94.0.4595.0
- Mozilla Firefox 91.0
- WebKit 15.0
バージョン 1.13
Playwright
- 🖖 プログラムによるドラッグアンドドロップのサポート。page.drag_and_drop() API を介して利用できます。
- 🔎 拡張された HAR には、リクエストとレスポンスのボディサイズが含まれます。browser.new_context() の
recordHarオプションを使用して利用できます。
ツール
- Playwright Trace Viewer に、パラメーター、戻り値、
console.log()呼び出しが表示されるようになりました。
新しいおよび刷新されたガイド
ブラウザのバージョン
- Chromium 93.0.4576.0
- Mozilla Firefox 90.0
- WebKit 14.2
新しい Playwright API
- browser.new_context() と browser.new_page() の新しい
baseURLオプション。 - response.security_details() および response.server_addr()。
- page.drag_and_drop() および frame.drag_and_drop()。
- download.cancel()
- page.input_value()、frame.input_value()、および element_handle.input_value()。
- page.fill()、frame.fill()、および element_handle.fill() の新しい
forceオプション。 - page.select_option()、frame.select_option()、および element_handle.select_option() の新しい
forceオプション。
バージョン 1.12
🧟♂️ Playwright Trace Viewer の紹介
Playwright Trace Viewer は、スクリプト実行後に記録された Playwright トレースを探索するのに役立つ新しい GUI ツールです。Playwright トレースを使用すると、
- 各 Playwright アクションの前後のページ DOM
- 各 Playwright アクションの前後のページレンダリング
- スクリプト実行中のブラウザネットワーク
トレースは、新しい browser_context.tracing API を使用して記録されます。
browser = chromium.launch()
context = browser.new_context()
# Start tracing before creating / navigating a page.
context.tracing.start(screenshots=True, snapshots=True)
page.goto("https://playwright.dokyumento.jp")
# Stop tracing and export it into a zip archive.
context.tracing.stop(path = "trace.zip")
トレースは後で Playwright CLI を使用して検査されます。
playwright show-trace trace.zip
これにより、以下の GUI が開きます。

👉 詳細については、トレースビューアのドキュメント を参照してください。
ブラウザのバージョン
- Chromium 93.0.4530.0
- Mozilla Firefox 89.0
- WebKit 14.2
このバージョンの Playwright は、以下の安定版チャンネルでもテストされています。
- Google Chrome 91
- Microsoft Edge 91
新しいAPI
- page.emulate_media()、browser_type.launch_persistent_context()、browser.new_context()、および browser.new_page() の
reducedMotionオプション。 - browser_context.on("request")
- browser_context.on("requestfailed")
- browser_context.on("requestfinished")
- browser_context.on("response")
- browser_type.launch() および browser_type.launch_persistent_context() の
tracesDirオプション。 - 新しい browser_context.tracing API 名前空間。
- 新しい download.page メソッド。
バージョン 1.11
🎥 新しい動画: Playwright: A New Test Automation Framework for the Modern Web (スライド)
- Playwrightについて話しました
- 舞台裏のエンジニアリング作業を披露しました
- 新機能のライブデモを実施しました ✨
- イベントを主催し、私たちを招待してくださった applitools に特別な感謝を申し上げます!
ブラウザのバージョン
- Chromium 92.0.4498.0
- Mozilla Firefox 89.0b6
- WebKit 14.2
新しいAPI
- page.expect_request() などのメソッドで、API 全体で**非同期述語**をサポート。
- 新しいエミュレーションデバイス: Galaxy S8, Galaxy S9+, Galaxy Tab S4, Pixel 3, Pixel 4
- 新しいメソッド
- URL へのナビゲーションを待機するための page.wait_for_url()。
- スクリーンレコーディングを管理するための video.delete() および video.save_as()。
- 新しいオプション
- browser.new_context() メソッドの
screenオプションで、window.screenの寸法をエミュレートできます。 - page.check() および page.uncheck() メソッドの
positionオプション。 - page.check()、page.uncheck()、page.click()、page.dblclick()、page.hover()、および page.tap() でアクションをドライランするための
trialオプション。
- browser.new_context() メソッドの
バージョン 1.10
- Playwright for Java v1.10 が安定版になりました!
- 新しい チャンネル API を使用して、**Google Chrome** および **Microsoft Edge** の安定版チャンネルに対して Playwright を実行します。
- Chromium のスクリーンショットは Mac & Windows で高速です。
バンドルされているブラウザのバージョン
- Chromium 90.0.4430.0
- Mozilla Firefox 87.0b10
- WebKit 14.2
このバージョンの Playwright は、以下の安定版チャンネルでもテストされています。
- Google Chrome 89
- Microsoft Edge 89
新しいAPI
- browser_type.launch() が新しい
'channel'オプションを受け入れるようになりました。詳細については、ドキュメント を参照してください。
バージョン 1.9
- Playwright Inspector は、テストを作成およびデバッグするための**新しい GUI ツール**です。
- Playwright スクリプトの行ごとのデバッグ、再生、一時停止、ステップ実行。
- ユーザーアクションを記録して新しいスクリプトを作成します。
- 要素にホバーすることで、スクリプトの要素セレクターを生成します。
- Inspector を起動するには、
PWDEBUG=1環境変数を設定します。
- ヘッダモードで page.pause() を使用して、**スクリプトの実行を一時停止**します。ページを一時停止すると、デバッグのために Playwright Inspector が起動します。
- CSS セレクターの**新しい
has-text疑似クラス**。:has-text("example")は、内部のどこか(子要素または子孫要素内である可能性もあります)に"example"を含む任意の要素に一致します。その他の例 を参照してください。 dialogイベントのリスナーが設定されていない限り、**ページダイアログは実行中に自動的に閉じられる**ようになりました。詳細については、こちら を参照してください。- Playwright for Python は、慣用的なスネークケース API と、CI/CD でテストを実行するためのプレビルドされた Docker イメージ を備え、**安定版**になりました。
ブラウザのバージョン
- Chromium 90.0.4421.0
- Mozilla Firefox 86.0b10
- WebKit 14.1
新しいAPI
バージョン 1.8
-
:left-of()、:right-of()、:above()、:below()を使用して、レイアウトに基づいて要素を選択します。 -
Playwright には、以前の playwright-cli が含まれるようになりました。
playwright --help -
page.select_option() が、オプションが存在するのを待つようになりました。
-
page.is_editable() のような要素の状態をアサートする新しいメソッド。
新しいAPI
- element_handle.is_checked().
- element_handle.is_disabled().
- element_handle.is_editable().
- element_handle.is_enabled().
- element_handle.is_hidden().
- element_handle.is_visible().
- page.is_checked().
- page.is_disabled().
- page.is_editable().
- page.is_enabled().
- page.is_hidden().
- page.is_visible().
- element_handle.wait_for_element_state() の新しいオプション
'editable'。
ブラウザのバージョン
- Chromium 90.0.4392.0
- Mozilla Firefox 85.0b5
- WebKit 14.1
バージョン 1.7
- 新しい Java SDK: Playwright for Java が JavaScript、Python、.NET バインディング と同等になりました。
- ブラウザストレージAPI: 認証シナリオを簡素化するために、ブラウザストレージ状態 (クッキー、ローカルストレージ) を保存および読み込むための新しい便利なAPI。
- 新しい CSS セレクター: より柔軟なセレクターに対するフィードバックを受け、セレクターの実装を刷新しました。Playwright 1.7 では、新しい CSS 拡張機能 が導入され、今後もさらに追加される予定です。
- 新しいウェブサイト: playwright.dev のドキュメントウェブサイトが更新され、現在は Docusaurus で構築されています。
- Apple Silicon のサポート: WebKit および Chromium 用の Playwright ブラウザバイナリが Apple Silicon 用にビルドされるようになりました。
新しいAPI
- browser_context.storage_state() で現在の状態を取得し、後で再利用できます。
- browser.new_context() および browser.new_page() の
storageStateオプションでブラウザコンテキストの状態を設定できます。
ブラウザのバージョン
- Chromium 89.0.4344.0
- Mozilla Firefox 84.0b9
- WebKit 14.1