
PuppeteerとPlaywrightって何が違うの? — 両方使い続けて分かった使い分けの話
📌 はじめに:「どっちを使えばいいの?」という混乱
ブラウザ自動化を始めてしばらく経った頃、AIにこんな質問をした。「PuppeteerとPlaywrightって、どっちを使えばいいの?」
返ってきた答えは「Playwrightのほうが新しくて高機能です。ただしPuppeteerにも根強い用途があります」。
……わかるようで、わからない。
私のリポジトリには今、両方のコードが混在している。eBay出品関連の処理はPuppeteer、案件クロールや新しい自動化はPlaywright、という具合だ。「なぜそうなったのか」を整理してみたら、意外と明快な答えが見えてきた。今回はその話をする。
(前回の記事: FIFOキューでChrome競合を防いだ話はこちら)
🔍 そもそも「ブラウザ自動化」とは
まず前提として、ブラウザ自動化というのを非エンジニアの言葉で説明すると「Chromeを自分の代わりに動かすしくみ」のことだ。
人間がマウスでクリックしたり、フォームに文字を入力したりする操作を、プログラムが代わりにやってくれる。eBayの発送情報を自動で登録したり、クラウドワークスの案件を毎時間チェックして条件に合えば自動で提案を送ったり——そういったことが可能になる。
PuppeteerとPlaywrightは、この「Chromeを動かす」ための道具だ。どちらもGoogle ChromeやEdge等を操作できる。問題は「どっちが自分の用途に向いているか」だった。
🛠️ 経緯:なぜ2つが混在することになったのか
最初に使ったのはPuppeteerだった。理由は単純で、2年前にAIに「ブラウザ自動化のライブラリは何がいいですか」と聞いたら「Puppeteerが実績豊富でおすすめです」と言ったからだ。Playwrightというツールがあることすらそのときは知らなかった。
実はその前に、headless(バックグラウンド)モードで動かそうとしていた時期がある。画面を出さずに裏で動かせれば効率的だと思ったからだ。でもheadlessモードは、実際にブラウザを表示して操作するときと挙動が変わる場面が多かった。「画面が見えないと再現できない」という壁にぶつかり、結局画面を出して動かす方針に切り替えた。それがPuppeteerを使い続けた背景でもある。
Puppeteerで最初に作ったのはeBayの送料テーブル自動更新だ。約82ヵ国×4つの重量帯にまたがる送料設定で、モーダル画面に並ぶ227個のチェックボックスを自動でON/OFFする処理だが、Puppeteerで問題なく動いた。その後もeBay関連の自動化は全てPuppeteerで構築していった。
問題が起きたのは、noteの記事投稿自動化を作ろうとしたときだ。headless(バックグラウンド)モードでnote.comを操作しようとしたら、「公開に進む」ボタンが反応しない。何度試してもダメだった。
AIに相談したら「Puppeteerのheadlessモードの制限の可能性があります。PlaywrightはChromiumを独自にコントロールするため、こういったケースで安定しやすいです」との回答。試しにPlaywrightに切り替えたら、あっさり動いた。
それ以来、新しく作る自動化はPlaywrightを使うルールにした。「既存は全部Playwrightに統一しよう」と試みたこともある。でも書き直す過程で「Puppeteerでしかうまく動かない場面もある」と気づいた。無理に統一するより、それぞれの得意なことをやらせる方が結果として安定した。そういう経緯で混在という結論に至っている。現在のコードベースではeBay・eLogi関連がPuppeteer、案件クロール・note関連がPlaywright、という分担になっている。
⚠️ 実際に感じた違い
2つを並行して使ってみて感じた違いを整理すると、こうなる。
| 項目 | Puppeteer | Playwright |
|------|-----------|------------|
| headlessモードの安定性 | △(サイトによる) | ✅(比較的安定) |
| セットアップの手軽さ | ✅(npm一発) | △(ブラウザ別ダウンロードあり) |
| 複数ブラウザ対応 | ❌(Chrome/Edge中心) | ✅(Firefox・Safari対応) |
| セッション管理 | △(工夫が必要) | ✅(storageState機能が便利) |
| 情報・事例の多さ | ✅(実績多) | △(Puppeteerより少ない) |
「どちらが優れているか」ではなく「どちらの得意領域か」の問題だと気づいた。Puppeteerが劣っているわけではなく、headlessモードへの対応やセッション管理といった点でPlaywrightのほうが現代のウェブサイトに合っている場面が多い、ということだ。
既存のPuppeteerコードを全部書き直す必要はない。動いているものはそのまま、新しく作るときはPlaywrightを選ぶ——これが今の方針だ。
📝 おわりに:「両方知っておく」が正解
「どっちを使えばいいか」という最初の質問の答えは、「新しく作るならPlaywright、既存がPuppeteerなら無理に移行しない」が私の結論だ。
ブラウザ自動化の世界では、ツールの優劣より「そのツールで今やりたいことが実現できるか」のほうが大事だと思っている。2つが混在している状態を「整理できていない」と感じていたが、それぞれが動いていれば問題ない。AIも「共存で問題ありません」と言っていたし、実際に統一を試みて「やっぱり混在でいい」という結論に自分で至ったことで、むしろ納得感が増した。
次の記事では、某クライアントのWordドキュメント自動化でハマった話を書く。「ExcelがJSZipなら、WordもJSZipでいけるはず」と思ってやってみたら、想定外の落とし穴があった。
Claude Code実践記|非エンジニアの全自動化 では、コードを一行も書かずにAI開発ツールを使いこなす実践ノウハウを発信しています。フォローしていただけると次の記事が届きます。