browser-automation
使用Playwright的浏览器自动化工具包。支持与Web应用程序交互、表单填写、截图、查看浏览器日志和运行自动化测试。在自动化浏览器任务、测试Web UI或抓取网页时使用。
📖 中文导读:使用Playwright的浏览器自动化工具包。支持与Web应用程序交互、表单填写、截图、查看浏览器日志和运行自动化测试。在自动化浏览器任务、测试Web UI或抓取网页时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: browser-automation description: Browser automation toolkit using Playwright. Supports interacting with web applications, form filling, capturing screenshots, viewing browser logs, and running automated tests. Use when automating browser tasks, testing web UI, or scraping web pages. keywords: playwright, browser, ブラウザ, 自動化, スクレイピング, e2e, screenshot, スクリーンショット, scraping
- Write
@playwright/testscripts in TypeScript, run withnpx playwright test - Use
scripts/with-server.mjs --helpto manage server lifecycle - Wait for
networkidlebefore inspecting DOM on dynamic apps
Quick Start
npx playwright install chromium- Install browser (one-time)npx playwright test your-test.spec.ts- Run a test
Approach
- Static HTML → Read file directly to identify selectors, then write test
- Dynamic app (server not running) → Use
with-server.mjsto start server, then test - Dynamic app (server running) → Navigate, wait for
networkidle, inspect, then act
Basic Test Structure
import {test, expect, type Page} from "@playwright/test";
test("verify homepage loads", async ({page}: {page: Page}) => {
await page.goto("http://localhost:5173");
await page.waitForLoadState("networkidle");
await expect(page.locator("h1")).toBeVisible();
});
Using with-server.mjs
# Single server
node scripts/with-server.mjs --server "npm run dev" --port 5173 -- npx playwright test
# Multiple servers
node scripts/with-server.mjs \
--server "cd backend && python server.py" --port 3000 \
--server "cd frontend && npm run dev" --port 5173 \
-- npx playwright test
Best Practices
- Use
expect()for assertions instead of manual checks - Browser cleanup is automatic with
@playwright/test - Use descriptive selectors:
text=,role=, CSS selectors, or IDs - Add waits:
page.waitForSelector()orexpect().toBeVisible()
Reference Files
examples/element-discovery.spec.ts- Discovering buttons, links, inputsexamples/static-html-automation.spec.ts- Using file:// URLsexamples/console-logging.spec.ts- Capturing console logs