Playwright核心测试指南：46个最佳实践与黄金法则，提升自动化测试质量

playwright-core by testdino-hq/playwright-skill

97 周安装量

158 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/testdino-hq/playwright-skill --skill playwright-core

自动化 JavaScript 框架测试

🇨🇳中文介绍

Playwright 核心测试

经过实践检验的、具有明确指导原则的 Playwright 指南——每种模式都包含何时（以及何时不）使用它。

46 个参考指南，涵盖 Playwright 测试的方方面面：选择器、断言、夹具、网络模拟、身份验证、视觉回归、无障碍访问、API 测试、调试等——贯穿始终提供 TypeScript 和 JavaScript 示例。

黄金法则

优先使用 getByRole() 而非 CSS/XPath —— 对标记更改具有弹性，反映用户查看页面的方式
绝不使用 page.waitForTimeout() —— 使用 expect(locator).toBeVisible() 或 page.waitForURL()
Web 优先的断言 —— expect(locator) 会自动重试；expect(await locator.textContent()) 则不会
—— 无共享状态，无执行顺序依赖

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

FlyClaw：零登录航班聚合查询工具，Python实现多源航班信息与价格搜索

4,000,000 周安装

Azure RBAC 权限管理工具：查找最小角色、创建自定义角色与自动化分配

131,500 周安装

README 国际化工具：自动化翻译与多语言文档管理 | readme-i18n

42,200 周安装

GitHub Actions 官方文档查询助手 - 精准解答 CI/CD 工作流问题

40,500 周安装

隔离每个测试

在配置中使用 baseURL —— 测试中零硬编码 URL

重试次数：CI 中为 2，本地为 0 —— 在重要环节暴露测试的不稳定性

跟踪：'on-first-retry' —— 提供丰富的调试工件，且不影响 CI 速度

使用夹具而非全局变量 —— 通过 test.extend() 共享状态，而非模块级变量

每个测试一个行为 —— 允许多个相关的 expect() 调用

仅模拟外部服务 —— 绝不模拟你自己的应用；模拟第三方 API、支付网关、电子邮件服务

您正在做什么	指南	深入探讨
选择选择器	locators.md	locator-strategy.md
断言与等待	assertions-and-waiting.md
组织测试套件	test-organization.md	test-architecture.md
Playwright 配置	configuration.md
夹具与钩子	fixtures-and-hooks.md
测试数据	test-data-management.md
身份验证与登录	authentication.md	auth-flows.md
API 测试 (REST/GraphQL)	api-testing.md
视觉回归	visual-regression.md
无障碍访问	accessibility.md
移动端与响应式	mobile-and-responsive.md
组件测试	component-testing.md
网络模拟	network-mocking.md	when-to-mock.md
表单与验证	forms-and-validation.md
文件上传/下载	file-operations.md	file-upload-download.md
错误与边界情况	error-and-edge-cases.md
CRUD 流程	crud-testing.md
拖放操作	drag-and-drop.md
搜索与筛选 UI	search-and-filter.md

问题	指南
通用调试工作流	debugging.md
特定错误信息	error-index.md
不稳定/间歇性测试	flaky-tests.md
常见初学者错误	common-pitfalls.md

框架	指南
Next.js (App Router + Pages Router)	nextjs.md
React (CRA, Vite)	react.md
Vue 3 / Nuxt	vue.md
Angular	angular.md

主题	指南
多用户与协作	multi-user-and-collaboration.md
WebSockets 与实时通信	websockets-and-realtime.md
浏览器 API (地理位置、剪贴板、权限)	browser-apis.md
iframe 与 Shadow DOM	iframes-and-shadow-dom.md
Canvas 与 WebGL	canvas-and-webgl.md
Service workers 与 PWA	service-workers-and-pwa.md
Electron 应用	electron-testing.md
浏览器扩展	browser-extensions.md
安全测试	security-testing.md
性能与基准测试	performance-testing.md
国际化与本地化	i18n-and-localization.md
多标签页与弹窗	multi-context-and-popups.md
时钟与时间模拟	clock-and-time-mocking.md
第三方集成	third-party-integrations.md

问题	指南
选择哪种定位器策略？	locator-strategy.md
E2E vs 组件 vs API 测试？	test-architecture.md
模拟服务还是真实服务？	when-to-mock.md

🇺🇸English

Playwright Core Testing

Opinionated, production-tested Playwright guidance — every pattern includes when (and when not) to use it.

46 reference guides covering the full Playwright testing surface: selectors, assertions, fixtures, network mocking, auth, visual regression, accessibility, API testing, debugging, and more — with TypeScript and JavaScript examples throughout.

Golden Rules

getByRole() over CSS/XPath — resilient to markup changes, mirrors how users see the page
Neverpage.waitForTimeout() — use expect(locator).toBeVisible() or page.waitForURL()
Web-first assertions — expect(locator) auto-retries; expect(await locator.textContent()) does not
Isolate every test — no shared state, no execution-order dependencies
baseURL in config — zero hardcoded URLs in tests
Retries:2 in CI, 0 locally — surface flakiness where it matters
Traces:'on-first-retry' — rich debugging artifacts without CI slowdown
Fixtures over globals — share state via test.extend(), not module-level variables
One behavior per test — multiple related expect() calls are fine
Mock external services only — never mock your own app; mock third-party APIs, payment gateways, email

Guide Index

Writing Tests

What you're doing	Guide	Deep dive
Choosing selectors	locators.md	locator-strategy.md
Assertions & waiting	assertions-and-waiting.md
Organizing test suites	test-organization.md	test-architecture.md
Playwright config	configuration.md
Fixtures & hooks	fixtures-and-hooks.md

Debugging & Fixing

Problem	Guide
General debugging workflow	debugging.md
Specific error message	error-index.md
Flaky / intermittent tests	flaky-tests.md
Common beginner mistakes	common-pitfalls.md

Framework Recipes

Framework	Guide
Next.js (App Router + Pages Router)	nextjs.md
React (CRA, Vite)	react.md
Vue 3 / Nuxt	vue.md
Angular	angular.md

Specialized Topics

Topic	Guide
Multi-user & collaboration	multi-user-and-collaboration.md
WebSockets & real-time	websockets-and-realtime.md
Browser APIs (geo, clipboard, permissions)	browser-apis.md
iframes & Shadow DOM	iframes-and-shadow-dom.md
Canvas & WebGL	canvas-and-webgl.md
Service workers & PWA	service-workers-and-pwa.md
Electron apps	electron-testing.md

Architecture Decisions

Question	Guide
Which locator strategy?	locator-strategy.md
E2E vs component vs API?	test-architecture.md
Mock vs real services?	when-to-mock.md

Weekly Installs

Repository

testdino-hq/pla…ht-skill

GitHub Stars

158

First Seen

Feb 16, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

codex91

github-copilot90

amp88

opencode88

kimi-cli88

gemini-cli88

Skills CLI 使用指南：AI Agent 技能包管理器安装与管理教程

40,000 周安装