🎭 Playwright Test Automation Framework

> 🚀 A powerful, data-driven test automation framework built with Playwright and TypeScript, leveraging @executeautomation/playwright-mcp-server for enhanced test recording and playback capabilities. Features Page Object Model design pattern for scalable and maintainable automated testing.

✨ Highlights

- 🏗️ Page Object Model - Clean and maintainable test architecture
- 📊 Data-Driven Testing - Easily scale tests with external test data
- 🔧 TypeScript Support - Robust type checking and better IDE integration
- ♻️ Reusable Components - Modular design for maximum code reuse
- 🎯 Easy Maintenance - Centralized locators and data management
- 📈 Scalable Design - Effortlessly add new test scenarios
- 🎥 MCP Server Integration - Enhanced test recording and playback functionality

🌟 Key Features

- Structured and organized test architecture
- Separation of test data from test logic
- Powerful helper methods for common operations
- Easy-to-follow page object pattern implementation
- Comprehensive test data management
- Ready-to-use registration flow example
- Test recording and playback using MCP Server
- Automated test script generation

Framework Structure

tests/
├── data/                    # Test Data Layer
│   ├── interfaces/         
│   │   └── TestData.ts     # Data type definitions
│   ├── TestDataHelper.ts   # Helper class for data management
│   └── testData.ts         # Test scenarios data
├── pages/                   # Page Objects
│   ├── BasePage.ts         # Base page with common functionality
│   ├── LoginPage.ts        # Login page object
│   └── RegistrationPage.ts # Registration page object
└── specs/                   # Test Specifications
    └── registration.spec.ts # Test cases

Features

- Page Object Model: Separates test logic from page interactions
- Data-Driven Testing: Test data is separated from test logic
- TypeScript: Strong typing and better IDE support
- Reusable Components: Common functionality in base classes
- Easy Maintenance: Centralized locators and data management
- Scalable: Easy to add new test scenarios and page objects

Test Data Structure

The framework uses a structured approach to manage test data:

interface TestScenario {
    name: string;
    login: LoginData;
    registration: RegistrationData;
}

Current test scenarios:
1. Valid Registration Flow (Male user)
2. Female User Registration

Setup

1. Clone the repository:

git clone <repository-url>

cd playwrightMCP_Demo

2. Install dependencies:

npm install

3. Install Playwright browsers:

npx playwright install

Running Tests

Run all tests:

npx playwright test

Run specific test file:

npx playwright test tests/specs/registration.spec.ts

Run tests in headed mode:

npx playwright test --headed

Adding New Test Scenarios

1. Add new test data in tests/data/testData.ts:

{

    name: 'Your Scenario Name',

    login: {

        email: 'your.email@test.com'

    },

    registration: {

        firstName: 'First',

        lastName: 'Last',

        address: 'Address',

        email: 'email@test.com',

        phone: '1234567890',

        gender: 'Male' | 'Female',

        country: 'Country Name'

    }

}

2. The test will automatically execute for new scenarios.

Framework Components

Page Objects

- BasePage: Contains common methods and utilities
- LoginPage: Handles login functionality
- RegistrationPage: Manages registration form interactions

Data Management

- TestData.ts: Contains test scenarios
- TestDataHelper: Provides methods to access and manage test data
- Interfaces: Defines structure for test data

Best Practices

1. Keep page objects focused on page-specific functionality
2. Maintain test data separately from test logic
3. Use meaningful scenario names
4. Follow TypeScript naming conventions
5. Keep tests independent and atomic

Contributing

1. Create a new branch for your feature
2. Add/Update tests and page objects
3. Update test data if needed
4. Submit a pull request

Dependencies

- Playwright
- TypeScript
- Node.js
- @executeautomation/playwright-mcp-server - For enhanced test recording and playback
- @playwright/test - Core testing framework

Support

For any questions or issues, please create a new issue in the repository.