Playwright CLI セッション管理: マルチブラウザセッション、分離、永続化、クリーンアップ

Wed, 15 Apr 2026 08:15:12 +0800

自動化に Playwright CLI を使用している場合は、すぐに実際的な問題に遭遇することになります。それは、相互に干渉せずに同時に複数のブラウザーセッションを開くことができるかということです。答えは「はい」です。Playwright CLI により、このメカニズムが非常に簡単になりました。

この記事は、公式 session-management リファレンスドキュメントに従い、名前付きセッション、セッション分離、永続性プロファイル、同時実行モード、一般的なクリーンアップコマンドなどの最も実用的な部分を整理します。この記事のコマンドラインとコマンドブロックの説明は、参考コンテンツとして保持されています。

01 ブラウザセッションに名前を付けます

公式の推奨事項は、-s パラメーターを使用して、異なるブラウザーコンテキストを分離することです。

# Browser 1: Authentication flow
playwright-cli -s=auth open https://app.example.com/login

# Browser 2: Public browsing (separate cookies, storage)
playwright-cli -s=public open https://example.com

# Commands are isolated by browser session
playwright-cli -s=auth fill e1 "user@example.com"
playwright-cli -s=public snapshot

ここで重要な点は、異なる session 名が異なるブラウザーコンテキストに対応するということです。ログインプロセスには auth を使用し、匿名アクセスには public を使用できます。 Cookie やローカル状態を共有しません。

02 ブラウザセッションは何を分離しますか?

各ブラウザセッションは、次のコンテンツを独立して保持します。

Cookies
LocalStorage / SessionStorage
IndexedDB
Cache
Browsing history
Open tabs

これは、auth セッションで Web サイトにログインしても、自動的には public セッションに影響を与えないことを意味します。これは、複数アカウントのテスト、ログイン検証、匿名比較を行う場合に特に重要です。

03 ブラウザセッション関連コマンド

公式ドキュメントには、セッション管理で最も一般的に使用される一連のコマンドがまとめられています。

# List all browser sessions
playwright-cli list

# Stop a browser session (close the browser)
playwright-cli close                 # stop the default browser
playwright-cli -s=mysession close   # stop a named browser

# Stop all browser sessions
playwright-cli close-all

# Forcefully kill all daemon processes (for stale/zombie processes)
playwright-cli kill-all

# Delete browser session user data (profile directory)
playwright-cli delete-data              # delete default browser data
playwright-cli -s=mysession delete-data # delete named browser data

これらは、次の 3 種類の操作として理解できます。

list: 現在利用可能な会話を確認します
close/close-all/kill-all: セッションを終了するか、スタックしたブラウザープロセスをクリーンアップします
delete-data: セッションに対応するユーザーデータディレクトリを削除します

ブラウザを終了するだけの場合は、通常、最初に close を使用します。残留プロセスまたはゾンビプロセスがある場合は、kill-all を使用する方が適切です。

04 環境変数を使用してデフォルトのセッションを設定します

コマンドごとに -s=mysession を繰り返し書きたくない場合は、公式が環境変数メソッドも提供しています。

1
2

export PLAYWRIGHT_CLI_SESSION="mysession"
playwright-cli open example.com  # Uses "mysession" automatically

このように、-s が明示的に指定されていない場合、コマンドはデフォルトで mysession ブラウザーセッションを使用します。

05 一般的なパターン: 同時クロール

参考資料には、同時クロールの非常に典型的な例が示されています。

#!/bin/bash
# Scrape multiple sites concurrently

# Start all browsers
playwright-cli -s=site1 open https://site1.com &
playwright-cli -s=site2 open https://site2.com &
playwright-cli -s=site3 open https://site3.com &
wait

# Take snapshots from each
playwright-cli -s=site1 snapshot
playwright-cli -s=site2 snapshot
playwright-cli -s=site3 snapshot

# Cleanup
playwright-cli close-all

このモードは、複数のサイトを同時に開き、ページのステータスを個別に取得して、それらをまとめてクリーンアップするのに適しています。各サイトは個別のセッションで実行されるため、互いのローカル状態を汚染することはありません。

06 一般的なパターン: A/B テストセッション

もう 1 つの一般的なシナリオは、異なる実験版を同時に比較することです。

# Test different user experiences
playwright-cli -s=variant-a open "https://app.com?variant=a"
playwright-cli -s=variant-b open "https://app.com?variant=b"

# Compare
playwright-cli -s=variant-a screenshot
playwright-cli -s=variant-b screenshot

この書き方は、2 つのバージョンが独立したセッションで実行され、スクリーンショットとステータスチェックを個別に管理しやすいため、A/B ページの差分比較に非常に適しています。

07 永続的なブラウザプロファイル

公式ドキュメントには具体的に次のように記載されています: デフォルトでは、ブラウザーのプロファイルはメモリにのみ保存されます。

ブラウザープロファイルをディスクに保存したい場合は、--persistent を open に追加する必要があります。

# Use persistent profile (auto-generated location)
playwright-cli open https://example.com --persistent

# Use persistent profile with custom directory
playwright-cli open https://example.com --profile=/path/to/profile

この機能は、ログインステータス、ローカルキャッシュ、または拡張デバッグ環境の長期的な再利用が必要なシナリオに適しています。特に、同じサイトを何度もデバッグする場合は、毎回最初から開始するよりもプロファイルを永続化する方が効率的であることがよくあります。

08 デフォルトのブラウザセッション

-s が明示的に渡されない場合、コマンドはデフォルトのブラウザーセッションを使用します。

# These use the same default browser session
playwright-cli open https://example.com
playwright-cli snapshot
playwright-cli close  # Stops default browser

つまり、-s のない複数のコマンドは、デフォルトで同じデフォルトセッション内で継続的に実行されます。

09 セッション構成で開く

セッション名に加えて、公式ではいくつかの一般的な起動設定方法も提供しています。

# Open with config file
playwright-cli open https://example.com --config=.playwright/my-cli.json

# Open with specific browser
playwright-cli open https://example.com --browser=firefox

# Open in headed mode
playwright-cli open https://example.com --headed

# Open with persistent profile
playwright-cli open https://example.com --persistent

これらのパラメータはセッション管理と組み合わせて使用できます。たとえば、名前付きセッションを常に firefox で実行したり、セッションを常に headed モードで開始して手動で観察しやすくしたりできます。

10 の公式ベストプラクティス

参考資料には、3 つの非常に実践的なベストプラクティスがリストされています。

1. セマンティックなセッション名を使用する

# GOOD: Clear purpose
playwright-cli -s=github-auth open https://github.com
playwright-cli -s=docs-scrape open https://docs.example.com

# AVOID: Generic names
playwright-cli -s=s1 open https://github.com

目的を直接表現するセッション名を付けるのが最善です。 github-auth や docs-scrape のような名前は、後でスクリプトを保守するときにはるかに明確になります。

2. 使用後は適時に掃除してください

# Stop browsers when done
playwright-cli -s=auth close
playwright-cli -s=scrape close

# Or stop all at once
playwright-cli close-all

# If browsers become unresponsive or zombie processes remain
playwright-cli kill-all

タスクの完了後にブラウザを閉じないと、セッションとバックグラウンドプロセスが残ります。短期的には大きな問題ではありませんが、タスクが多すぎると環境が混乱しやすくなります。

3. 古いブラウザデータを削除する

1
2

# Remove old browser data to free disk space
playwright-cli -s=oldsession delete-data

一部の古いセッションが使用されなくなった場合、対応するデータディレクトリを削除すると、ディスク領域を節約し、後で期限切れステータスの悪用を避けることができます。

11 簡単なまとめ

重要なポイントだけに焦点を当てると、次のことを思い出すことができます。

-s=<name> は、独立したブラウザセッションを作成および使用するために使用されます。
Cookie、ストレージ、キャッシュ、履歴、タブはセッション間で分離されます
close-all は統合シャットダウンに適しており、kill-all は異常な残留プロセスの処理に適しています。
--persistent は、長期間の再利用に適したプロファイルをディスクにダウンロードするために使用されます。
セッション名はできる限りセマンティックである必要があり、古いデータは定期的にクリーンアップする必要があります。

ワークフローにすでにログイン状態の再利用、複数アカウントの並列処理、A/B 比較、またはバッチクロールのニーズがある場合、基本的に session management は、Playwright CLI の機能を習得するのに最も価値があります。

参考リンク

Playwright CLI セッション管理リファレンスドキュメント: https://github.com/microsoft/playwright-cli/blob/main/skills/playwright-cli/references/session-management.md
Playwright CLI プロジェクトのホームページ: https://github.com/microsoft/playwright-cli

Session Management on KnightLiブログ

Playwright CLI セッション管理: マルチブラウザ セッション、分離、永続化、クリーンアップ