Jeffallan/claude-skills / skills/playwright-expert
playwright-expert
VerifiedUse when writing E2E tests with Playwright, setting up test infrastructure, or debugging flaky browser tests. Invoke to write test scripts, create page objects, configure test fixtures, set up reporters, add CI integration, implement API mocking, or perform visual regression testing. Trigger terms: Playwright, E2E test, end-to-end, browser testing, automation, UI testing, visual testing, Page Object Model, test flakiness.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.6 KB |
| references/api-mocking.md | markdown | 3.1 KB |
| references/configuration.md | markdown | 3.2 KB |
| references/debugging-flaky.md | markdown | 3.1 KB |
| references/page-object-model.md | markdown | 3.6 KB |
| references/selectors-locators.md | markdown | 2.7 KB |
references/selectors-locators.md
View on GitHub# Selectors & Locators
## Selector Priority (Best to Worst)
```typescript
// 1. Role-based (BEST - accessible)
await page.getByRole('button', { name: 'Submit' });
await page.getByRole('textbox', { name: 'Email' });
await page.getByRole('link', { name: 'Home' });
await page.getByRole('heading', { level: 1 });
// 2. Label/placeholder (good for forms)
await page.getByLabel('Email address');
await page.getByPlaceholder('Enter your email');
// 3. Test ID (good for non-semantic elements)
await page.getByTestId('user-avatar');
await page.getByTestId('submit-button');
// 4. Text content
await page.getByText('Welcome back');
await page.getByText(/welcome/i); // Case insensitive
// 5. CSS/XPath (AVOID - brittle)
await page.locator('.submit-btn'); // Last resort
await page.locator('#email-input');
```
## Role-Based Selectors
```typescript
// Buttons
page.getByRole('button', { name: 'Submit' });
page.getByRole('button', { name: /save/i });
// Links
page.getByRole('link', { name: 'Documentation' });
// Inputs
page.getByRole('textbox', { name: 'Username' });
page.getByRole('checkbox', { name: 'Remember me' });
page.getByRole('combobox', { name: 'Country' });
// Navigation
page.getByRole('navigation');
page.getByRole('main');
page.getByRole('banner');
// Tables
page.getByRole('row', { name: 'John Doe' });
page.getByRole('cell', { name: 'Active' });
```
## Filtering Locators
```typescript
// Filter by text
page.getByRole('listitem').filter({ hasText: 'Product A' });
// Filter by child locator
page.getByRole('listitem').filter({
has: page.getByRole('button', { name: 'Delete' })
});
// Filter by NOT having
page.getByRole('listitem').filter({
hasNot: page.getByText('Sold out')
});
// Chain locators
page.getByTestId('product-card').getByRole('button', { name: 'Buy' });
```
## Handling Multiple Elements
```typescript
// Get nth element (0-indexed)
page.getByRole('listitem').nth(0);
page.getByRole('listitem').first();
page.getByRole('listitem').last();
// Count elements
const count = await page.getByRole('listitem').count();
// Iterate
for (const item of await page.getByRole('listitem').all()) {
console.log(await item.textContent());
}
```
## Test IDs
```html
<!-- Add in HTML -->
<button data-testid="submit-button">Submit</button>
```
```typescript
// Configure custom attribute
// playwright.config.ts
use: {
testIdAttribute: 'data-test-id'
}
// Use in tests
page.getByTestId('submit-button');
```
## Quick Reference
| Locator | Best For |
|---------|----------|
| `getByRole()` | Buttons, links, inputs |
| `getByLabel()` | Form fields |
| `getByPlaceholder()` | Inputs without labels |
| `getByTestId()` | Non-semantic elements |
| `getByText()` | Static text |
| `filter()` | Narrowing results |
| `nth()` / `first()` | Multiple matches |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |