~/教學/TESTER.md
Claude Code 做的表單,Playwright 一跑壞了 3 個:用看不見的 Chrome 測空白、錯的 email、連按、超長名字和手機寬度
叫 Claude Code 用 Playwright 把表單當成亂來的使用者測一遍:安裝指令、可複製的測試提示詞、看報告、把失敗丟回給 Claude 修,加上 MCP 和 CLI 兩種用法。
在 Instagram 看這支 Reels留言關鍵字 #TESTER 就會收到這篇
自己點一次都會過,但使用者會亂填、會連按、會用手機。Playwright 是 Microsoft 的免費開源工具,會在背景開好幾個看不見的 Chrome,同時把你的表單點過一遍,再給你一份報告。這篇是 Reels 裡 TESTER 那支的完整版:我真的跑了一次,6 個測試壞了 3 個,也把怎麼裝、怎麼叫 Claude Code 寫測試(提示詞可以直接複製)、怎麼看報告、怎麼丟回給 Claude 修好都寫下來。所有指令都照官方頁面,我在 2026 年 11 月 12 日核對過。
01先看結果:6 個測試,壞了 3 個

我用 Claude Code 做了一個很簡單的註冊表單:名字、Email、一個「建立帳號」按鈕。自己點一次,一切正常。接著叫 Claude 用 Playwright 把它當成「亂來的使用者」測一遍:6 個測試同時在背景跑,壞了 3 個。
看完這篇你會拿到:
- 安裝 Playwright 的一行指令。
- 叫 Claude Code 寫測試的提示詞(空白、錯的 email、連按兩次、超長名字、手機寬度),可以直接複製。
- 怎麼看報告、怎麼把失敗的測試丟回給 Claude 修。
- 另外兩種用法:讓 Claude 自己開瀏覽器的 Playwright MCP,和官方給寫程式代理用的 Playwright CLI。
02第 1 步:在專案裡裝 Playwright
Playwright 是 Microsoft 的開源測試工具(Apache-2.0 授權,免費)。它可以用 Chromium、Firefox、WebKit 打開你的網頁,像真人一樣填表單、按按鈕,再檢查結果對不對。官方文件寫得很清楚:預設是 headless(看不見的瀏覽器),而且好幾個測試同時跑。
npm init playwright@latest
- 它會問你用 TypeScript 還是 JavaScript、測試放哪個資料夾、要不要加 GitHub Actions、要不要下載瀏覽器,照預設按 Enter 就可以。
- 已經有專案也能裝,它會把 Playwright 加進你現在的 package.json,不會蓋掉你的檔案。
- Node.js 要 22、24 或 26 版(官方文件 2026 年 11 月寫的)。
03第 2 步:叫 Claude Code 把表單當成「亂來的使用者」測

重點是把「會亂來的情況」一個一個列出來。Claude 自己想也想得到一些,但你列清楚,它就不會漏。
用 Playwright 幫[註冊表單 /signup]寫測試,把它當成會亂來的使用者: 1. 正常填寫,要能註冊成功 2. 欄位全空白,不能送出 3. 錯的 email(例如 vivian@gmail),要擋下來 4. 按鈕連按兩次,只能建一個帳號 5. 超長的名字(120 個字),版面不能被撐破 6. 手機寬度(375 px),按鈕要完整看得到 全部用 headless 同時跑,跑完告訴我哪幾個沒過、為什麼。
- 空白:很多表單只在前端擋,後端沒擋。
- 錯的 email:瀏覽器內建的 email 檢查會讓 vivian@gmail(沒有 .com)過關,這是我的表單真的漏掉的。
- 連按兩次:送出時按鈕沒有先鎖住,就會送兩次,我的表單因此建了兩個帳號。
- 超長名字:一長串沒有空格的英文字不會自動換行,會衝出卡片。
- 手機寬度:桌機看起來好好的,手機上按鈕可能被切掉。
04第 3 步:跑測試、看報告
npx playwright test
npx playwright show-report

我的那次是「Running 6 tests using 6 workers」:6 個看不見的 Chrome 同時開,每個測試一個。有測試沒過時,報告會自己打開;每個失敗的測試都有錯誤訊息和當下的截圖。


05第 4 步:把報告丟回給 Claude,修好再跑
報告裡每個失敗的測試右上角都有「Copy prompt」按鈕,會把錯誤和相關的程式碼整理成一段文字。按下去,直接貼給 Claude Code。
這是 Playwright 的報告,[3]個測試沒過:[貼上 Copy prompt 的內容] 幫我修好表單,不要改測試,修完再跑一次 npx playwright test,全部通過才算完成。

我的表單改了四個地方:email 要有「.」後面的網域才收,送出時先把按鈕鎖住,歡迎訊息加上自動換行,名字改用純文字放進頁面。
06另外兩種用法:Playwright MCP 和 Playwright CLI
上面是寫成測試檔,之後每次改程式都能重跑。如果你只是想讓 Claude 現在就打開網頁、自己點點看,Microsoft 還有兩個官方工具。
claude mcp add playwright npx @playwright/mcp@latest
Playwright MCP 預設會打開看得到的瀏覽器視窗。想讓它在背景跑,在指令後面加 --headless;因為多了參數,要在伺服器指令前面加 --(Claude Code 官方文件的寫法):
claude mcp add playwright -- npx @playwright/mcp@latest --headless
npm install -g @playwright/cli@latest playwright-cli install --skills
Playwright CLI 預設就是看不見的瀏覽器,要 Node.js 20 以上。我用它在沒修好的表單上試了一次:打開網頁、填好、連按兩次,查到一樣建了 2 個帳號。
07要注意
- Playwright 只測你寫進去的情況。清單越完整,抓到的越多;沒寫的它不會自己想到。
- 只測你自己的網站,或你有權限測的網站。
- 安裝指令只從官方頁面複製:playwright.dev、github.com/microsoft/playwright-mcp、github.com/microsoft/playwright-cli。
- 我的表單是示範用的小範例,「6 個壞 3 個」是那一次的結果,不代表你的網站。
- 版本會變:Playwright 1.65.0、Playwright MCP 0.0.85、Playwright CLI 0.1.24、Node 版本要求,都是 2026 年 11 月 12 日查的。
資料來源
下一支 Reel 想學什麼?
我每天測 Claude 和 AI 工具,把真的有用的做成 Reel。追蹤 @vivianlin.tech,新教學一出來就看得到。