Token导航 LogoToken导航TokenDH.com
开发敏感数据github未标认证来源可访问许可证需确认审计提醒

playwrightPlaywright 浏览器测试

Agent Skill

用于辅助测试设计、自动化测试、用例整理和回归验证。它适合让 Agent 编写单元测试、端到端测试、测试计划或根据失败日志定位问题。使用时需要确认项目测试框架、运行命令和夹具数据,避免为了通过测试而改坏真实逻辑;涉及浏览器或外部服务时,应区分本地模拟、测试环境和生产环境。

总安装

376

周安装

16

GitHub Stars

3

下载量

132
CodexClaudeCursorGemini CLI

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

GitHub

来源数

2

许可证

unknown

最后核验

2026-05-01

来源状态

来源可访问

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:playwright(Playwright 浏览器测试)
来源仓库:https://github.com/fellipeutaka/leon
仓库路径:skills/playwright
安装命令:
npx skills add https://github.com/fellipeutaka/leon --skill playwright
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

skills.shnpx skills
npx skills add https://github.com/fellipeutaka/leon --skill playwright

简介

playwright 用于辅助测试设计、自动化测试和回归验证。

  • 适合编写单元测试、端到端测试或根据日志定位问题。
  • 使用时需确认项目测试框架、运行命令和夹具数据。
  • 涉及浏览器或服务时应区分本地模拟与生产环境。
  • 避免为通过测试而破坏真实业务逻辑。playwright 属于开发类 Skill,可作为该场景下的辅助能力补充。

SKILL.md

Playwright

Core Workflow

  1. Analyze - Identify user flows and test scope
  2. Configure - Set up playwright.config.ts (see references/configuration.md)
  3. Write tests - Use proper locators, auto-waiting, and assertions
  4. Organize - Apply fixtures, POM, parallelism (see references/test-organization.md)
  5. Debug - Use traces, UI mode (see references/debugging.md)

Reference Guide

Load based on context:

TopicReferenceLoad When
Locators & Actionsreferences/locators-and-actions.mdWriting selectors, filling forms, clicking, drag-and-drop
Test Organizationreferences/test-organization.mdFixtures, parallel execution, retries, sharding, timeouts, annotations
Authenticationreferences/authentication.mdLogin flows, multi-role tests, storageState
Network & Mockingreferences/network-and-mocking.mdAPI mocking, route interception, HAR recording, API testing
Visual Testingreferences/visual-testing.mdScreenshots, snapshots, ARIA snapshots, visual regression
Debuggingreferences/debugging.mdFlaky tests, trace viewer, UI mode, debug flags
Configurationreferences/configuration.mdplaywright.config.ts, projects, web server, CI/CD, reporters
Advancedreferences/advanced.mdClock mocking, evaluate, component testing, POM, accessibility

Critical Rules

MUST DO

  • Use getByRole() > getByLabel() > getByTestId() > getByText() (in priority order)
  • Use web-first assertions: await expect(locator).toBeVisible() (auto-retries)
  • Keep tests independent - no shared mutable state between tests
  • Enable trace: 'on-first-retry' for debugging failures
  • Use fullyParallel: true for speed
  • Use forbidOnly:!!process.env.CI to prevent .only leaking to CI

MUST NOT

  • Use waitForTimeout() — always use proper auto-waiting assertions
  • Use CSS class selectors — they break on refactors
  • Use expect(await locator.isVisible()).toBe(true) — this does NOT auto-retry; use await expect(locator).toBeVisible() instead
  • Share state between tests (each test gets a fresh BrowserContext)
  • Use first()/nth() without narrowing first — filter or chain locators instead

Common Gotchas

  1. Assertion retrying: Only expect(locator) retries. expect(await locator.something()) evaluates once.
  2. has-text pseudo-class: Without another CSS specifier, matches everything including <body>. Always combine with an element selector.
  3. getByText whitespace: Always normalizes whitespace, even with exact: true.
  4. opacity: 0: Considered visible. Zero-size elements are NOT visible.
  5. Shadow DOM: All locators pierce Shadow DOM by default EXCEPT XPath.
  6. fill() actionability: Checks Visible + Enabled + Editable only. Does NOT check Stable or Receives Events.
  7. press()/pressSequentially(): NO actionability checks at all.
  8. Dialogs: Listener MUST handle (accept/dismiss) the dialog or the page action will stall permanently.
  9. storageState: Covers cookies, localStorage, IndexedDB. Does NOT cover sessionStorage.
  10. TypeScript: Playwright does NOT type-check — it only transpiles. Run tsc separately.
  11. expect.toPass timeout: Defaults to 0 (no retry), NOT the expect timeout.
  12. Glob patterns: * does not match /. ** matches everything. ? matches literal ? only.
  13. Serial mode retries: Retries ALL tests in the group, not just the failed one.
  14. Worker shutdown: Worker processes are always killed after a test failure.
  15. Drag events: For dragover to fire in all browsers, issue TWO mouse.move() calls.
  16. Videos: Only available AFTER page/context is closed.

Quick Setup

# New project
npm init playwright@latest

# Existing project
npm i -D @playwright/test
npx playwright install

Minimal Config

import { defineConfig, devices } from '@playwright/test';

export default defineConfig({
  testDir: './e2e',
  fullyParallel: true,
  forbidOnly: !!process.env.CI,
  retries: process.env.CI ? 2 : 0,
  workers: process.env.CI ? 1 : undefined,
  reporter: 'html',
  use: {
    baseURL: 'http://localhost:3000',
    trace: 'on-first-retry',
    screenshot: 'only-on-failure',
  },
  projects: [
    { name: 'chromium', use: { ...devices['Desktop Chrome'] } },
    { name: 'firefox', use: { ...devices['Desktop Firefox'] } },
    { name: 'webkit', use: { ...devices['Desktop Safari'] } },
  ],
  webServer: {
    command: 'npm run dev',
    url: 'http://localhost:3000',
    reuseExistingServer: !process.env.CI,
  },
});

Minimal Test

import { test, expect } from '@playwright/test';

test('homepage has title', async ({ page }) => {
  await page.goto('/');
  await expect(page).toHaveTitle(/My App/);
  await expect(page.getByRole('heading', { name: 'Welcome' })).toBeVisible();
});

CLI Quick Reference

npx playwright test                          # Run all
npx playwright test auth.spec.ts             # Run file
npx playwright test --grep @smoke            # Run tagged
npx playwright test --project=chromium       # Single browser
npx playwright test --debug                  # Debug mode (headed, timeout=0, workers=1)
npx playwright test --ui                     # UI mode
npx playwright show-report                   # HTML report
npx playwright show-trace trace.zip          # View trace
npx playwright codegen localhost:3000        # Generate tests

适合场景

01

用户想查找某类 Agent Skill 时

02

需要根据任务场景推荐可安装能力包时

03

需要对比不同来源的安装命令和来源信息时

能力概览

能力 1

按任务关键词查找相关 Skills

能力 2

展示可复制的安装命令

能力 3

保留来源站点、仓库和原始说明,方便继续核验

能力 4

展示第三方安全扫描或审计结果

安装后应在对应宿主中按原始 README 的触发条件使用;具体调用方式请以来源页面和 README 为准。

平台分布

Codex

36.64%
按下载量换算48

Claude

29.16%
按下载量换算38

Cursor

19.61%
按下载量换算26

Gemini CLI

10.25%
按下载量换算14

安全审计

Gen Agent Trust Hub

通过

Socket

可疑

Snyk

通过

权限和风险

敏感数据

该 Skill 可能接触密钥、Token、环境变量或敏感配置,应进入高风险复核队列,默认不自动发布。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。来源安全扫描存在 warning/failed 结果,不能写成本站确认安全。当前只有一个来源,正式发布前建议补源仓库或其他目录站核验。

来源信息

继续浏览同类 Skills