Playwright Test Generator 🎭

Automated Page Object and Functional Test Generator for Playwright with TypeScript support.

Features ✨

- 🎯 Automatic Page Object generation - Intelligently scans pages and creates type-safe Page Objects
- 🧪 Comprehensive functional test scenarios - Generates positive/negative test cases
- 🧭 Smart navigation discovery - Automatically detects navigation paths
- 📝 Form validation testing - Creates tests for form interactions and validations
- 🌍 Multi-environment support - Dev, QA, Prod environment configurations
- 💼 TypeScript support - Fully typed with excellent IDE support
- 🎨 Interactive CLI - User-friendly command-line interface
- ⚡ Fast setup - Get started in minutes

Installation 📦

``bash
npm install -g playwright-test-generator
`

Quick Start 🚀

$3

`bash

.env.qa

QA_APP_URL=https://your-qa-app.com
QA_USERNAME=testuser
QA_PASSWORD=testpass

.env.dev

DEV_APP_URL=https://your-dev-app.com
DEV_USERNAME=devuser
DEV_PASSWORD=devpass
`

$3

`bash
generate-page-object --env qa
`

$3

`bash
generate-functional-tests --env qa --depth 2
`

CLI Commands 🛠️

$3

`bash
generate-page-object [options]

Options:
-e, --env Environment (dev, qa, prod) (default: "qa")
-h, --headless Run in headless mode (default: false)
-o, --output Output directory (default: "./pageObjects")
--help Display help
`

$3

`bash
generate-functional-tests [options]

Options:
-e, --env Environment (dev, qa, prod) (default: "qa")
-h, --headless Run in headless mode (default: false)
-d, --depth Test depth (1 or 2) (default: "1")
-o, --output Output directory (default: "./tests")
--help Display help
`

Programmatic Usage 💻

`typescript
import {
PageObjectGenerator,
TestScenarioGenerator,
NavigationHelper
} from 'playwright-test-generator';

// Use in your own scripts
const generator = new PageObjectGenerator(page);
await generator.generatePageObject('LoginPage', './pageObjects');
`

Generated Output 📁

`
your-project/
├── pageObjects/
│ ├── LoginPage.ts
│ ├── DashboardPage.ts
│ └── UserManagementPage.ts
└── tests/
└── e2e/
├── loginTests.spec.ts
├── dashboardTests.spec.ts
└── userManagementTests.spec.ts
`

Example Generated Page Object

`typescript
import { Page, Locator, expect } from '@playwright/test';

export class LoginPage {
private page: Page;

constructor(page: Page) {
this.page = page;
}

// Locators
get usernameInput(): Locator {
return this.page.locator('input[name="username"]');
}

get passwordInput(): Locator {
return this.page.locator('input[name="password"]');
}

get loginButton(): Locator {
return this.page.locator('button[type="submit"]');
}

// Methods
async fillUsername(value: string): Promise {
await this.usernameInput.fill(value);
}

async fillPassword(value: string): Promise {
await this.passwordInput.fill(value);
}

async clickLogin(): Promise {
await this.loginButton.click();
}

async verifyPageLoaded(): Promise {
await this.page.waitForLoadState('networkidle');
}
}
`

Requirements 📋

- Node.js 16+
- @playwright/test ^1.40.0

License 📄

MIT

Contributing 🤝

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature`)
5. Open a Pull Request

Support 💬

- 📧 Email: Keerthi.vasan9790@gmail.com
- 🐛 Issues: GitHub Issues
- 📖 Docs: Documentation