Home

Welcome

This is the wiki for the Playwright + TypeScript Automation Framework.

Quick Links

• Setup
• Architecture
• MCP Server (AI Integration)
• Page Object Model
• API Testing
• Docker
• CI/CD

Getting Started

git clone https://github.com/yhAutomationQA/playwright-typescript-framework.git
cd playwright-typescript-framework
npm install
npx playwright install
npm test

Page Object Model

Pages extend BasePage and use Playwright's built-in auto-waiting:

Page	Purpose
LoginPage	Login/logout flows
InventoryPage	Product browsing and cart management
CartPage	Cart review and checkout

API Testing

The ApiClient fixture provides typed HTTP methods (GET, POST, PUT, DELETE) with query params, custom headers, and timeout support.

Docker

npm run docker:test

Runs inside mcr.microsoft.com/playwright with all browsers and system dependencies.

CI/CD

• GitHub Actions — lint, Snyk scan, cross-browser tests (chromium/firefox/webkit)
• Jenkins — full pipeline with Docker, reports, and security scanning
• SonarCloud — auto-analysis with quality gate on PRs

Environment Config

Set ENV=dev|qa|staging|prod to switch environments. Defaults to dev.

Security

Snyk dependency scanning runs in CI. Local: npm run snyk:test.

AI Integration (MCP)

The framework includes a Model Context Protocol server for AI-assisted browser automation. See MCP Server for details.