playwright-best-practices

name	playwright-best-practices
description	Core patterns for writing maintainable, reliable Playwright tests with TypeScript. Use when writing new tests, refactoring existing ones, or reviewing test quality. Covers test structure, selectors, waits, assertions, page objects, fixtures, and common anti-patterns.

Playwright Best Practices Skill

This skill contains comprehensive best practices for writing maintainable, reliable Playwright tests with TypeScript.

Core Principles

1. Tests should be reliable - No flaky tests
2. Tests should be fast - Parallel execution, efficient waits
3. Tests should be maintainable - Clear structure, reusable code
4. Tests should be readable - Self-documenting, clear intent
5. Tests should be isolated - No dependencies between tests

Table of Contents

• Test Structure
• Selectors
• Waits and Timing
• Assertions
• Page Objects
• Fixtures
• Test Organization
• Error Handling
• Common Anti-Patterns

---

Test Structure

✅ Good Practice

import { test, expect } from '@playwright/test';
import { LoginPage } from '../page-objects/LoginPage';

test.(,  {
  (,  ({ page }) => {
     loginPage =  (page);
    
     loginPage.();
     loginPage.(, );
    
     (page).();
     (page.(, { :  })).();
  });

  (,  ({ page }) => {
     loginPage =  (page);
    
     loginPage.();
     loginPage.(, );
    
     (loginPage.).();
     (loginPage.).();
  });
});