chore: initial commit — Playwright automation framework

Add project skeleton: tests, pages, locators, Playwright config, GitHub Actions workflow, and package manifest.
- Page Object Model for UI tests
- Example UI test (SauceDemo)
- Test data and locators
- CI workflow to run Playwright tests and upload reports

Author: prasanna.kurawadi

.github/workflows/playwright.yml

@@ -0,0 +1,27 @@
+name: Playwright Tests
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+jobs:
+  test:
+    timeout-minutes: 60
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    - uses: actions/setup-node@v4
+      with:
+        node-version: lts/*
+    - name: Install dependencies
+      run: npm ci
+    - name: Install Playwright Browsers
+      run: npx playwright install --with-deps
+    - name: Run Playwright tests
+      run: npx playwright test
+    - uses: actions/upload-artifact@v4
+      if: ${{ !cancelled() }}
+      with:
+        name: playwright-report
+        path: playwright-report/
+        retention-days: 30

.gitignore

@@ -0,0 +1,9 @@
+
+# Playwright
+node_modules/
+/test-results/
+/playwright-report/
+/blob-report/
+/playwright/.cache/
+/playwright/.auth/
+package-lock.json

locators/login.locators.ts

@@ -0,0 +1,19 @@
+// locators/login.locators.ts
+
+export class LoginLocators {
+  // Input fields
+  static readonly USERNAME_INPUT = '[data-test="username"]';
+  static readonly PASSWORD_INPUT = '[data-test="password"]';
+  
+  // Buttons
+  static readonly LOGIN_BUTTON = '[data-test="login-button"]';
+  
+  // Error messages
+  static readonly ERROR_MESSAGE = '[data-test="error"]';
+  static readonly ERROR_CLOSE_BUTTON = '.error-button';
+  
+  // Post-login elements (for verification)
+  static readonly INVENTORY_CONTAINER = '.inventory_container';
+  static readonly APP_LOGO = '.app_logo';
+  static readonly SHOPPING_CART = '.shopping_cart_link';
+}

package.json

@@ -0,0 +1,43 @@
+{
+  "name": "playwright-automation-framework",
+  "version": "1.0.0",
+  "description": "Production-ready Playwright test automation framework with SauceDemo App. Features separated locators, Page Object Model, UI testing.",
+  "scripts": {
+    "test": "npx playwright test",
+    "test:ui": "npx playwright test tests/ui",
+    "test:headed": "npx playwright test --headed",
+    "test:chrome": "npx playwright test --project=chrome",
+    "report": "npx playwright show-report",
+    "trace": "npx playwright show-trace"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kurawadiprasanna/playwright-automation-framework.git"
+  },
+  "keywords": [
+    "playwright",
+    "automation",
+    "testing",
+    "e2e",
+    "api-testing",
+    "typescript",
+    "conduit",
+    "test-automation",
+    "page-object-model",
+    "ci-cd",
+    "quality-assurance",
+    "selenium-alternative"
+  ],
+  "author": "Prasanna Kurawadi",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/kurawadiprasanna/playwright-automation-framework/issues"
+  },
+  "homepage": "https://github.com/kurawadiprasanna/playwright-automation-framework#readme",
+  "devDependencies": {
+    "@faker-js/faker": "^10.0.0",
+    "@playwright/test": "^1.55.1",
+    "@types/node": "^24.6.2",
+    "typescript": "^4.9.5"
+  }
+}

pages/Login.Page.ts

@@ -0,0 +1,37 @@
+import { Page, Locator } from '@playwright/test';
+import { LoginLocators } from '../locators/login.locators';
+
+export class LoginPage {
+  readonly page: Page;
+  readonly usernameInput: Locator;
+  readonly passwordInput: Locator;
+  readonly signInButton: Locator;
+  readonly errorMessage: Locator;
+  readonly appLogo: Locator;
+  readonly shoppingCart: Locator;
+
+  constructor(page: Page) {
+    this.page = page;
+    this.usernameInput = page.locator(LoginLocators.USERNAME_INPUT);
+    this.passwordInput = page.locator(LoginLocators.PASSWORD_INPUT);
+    this.signInButton = page.locator(LoginLocators.LOGIN_BUTTON);
+    this.errorMessage = page.locator(LoginLocators.ERROR_MESSAGE);
+    this.appLogo = page.locator(LoginLocators.APP_LOGO);
+    this.shoppingCart = page.locator(LoginLocators.SHOPPING_CART);
+  }
+
+  async navigate() {
+    // Sauce Demo's login page is the app root
+    await this.page.goto('/');
+  }
+
+  async login(username: string, password: string) {
+    await this.usernameInput.fill(username);
+    await this.passwordInput.fill(password);
+    await this.signInButton.click();
+  }
+
+  async getErrorMessage() {
+    return await this.errorMessage.textContent();
+  }
+}

pages/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "moduleResolution": "node",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "types": ["node", "@playwright/test"]
+  },
+  "include": [
+    "**/*.ts"
+  ],
+  "exclude": [
+    "node_modules",
+    "test-results",
+    "playwright-report"
+  ]
+}

playwright.config.ts

@@ -0,0 +1,36 @@
+import { defineConfig, devices } from '@playwright/test';
+
+export default defineConfig({
+  testDir: './tests',
+  fullyParallel: true,
+  forbidOnly: !!process.env.CI,
+  retries: process.env.CI ? 2 : 0,
+  workers: process.env.CI ? 1 : undefined,
+  reporter: [
+    ['html'],
+    ['list'],
+    ['junit', { outputFile: 'test-results/junit.xml' }]
+  ],
+  
+  use: {
+    baseURL: 'https://www.saucedemo.com/',
+    trace: 'on-first-retry',
+    screenshot: 'only-on-failure',
+    video: 'retain-on-failure',
+  },
+
+  projects: [
+    {
+      name: 'chromium',
+      use: { ...devices['Desktop Chrome'] },
+    },
+    {
+      name: 'firefox',
+      use: { ...devices['Desktop Firefox'] },
+    },
+    {
+      name: 'webkit',
+      use: { ...devices['Desktop Safari'] },
+    },
+  ],
+});

test-data/login-testdata.json

@@ -0,0 +1,13 @@
+{
+  "validUsers": [
+    {
+      "username": "standard_user",
+      "password": "secret_sauce",
+      "description": "standard user",
+      "expectedPostLogin": {
+       "appLogoText": "Swag Labs",
+       "urlPattern": "inventory.html"
+       }
+    }
+  ]
+}

tests/ui/auth/login.spec.ts

@@ -0,0 +1,25 @@
+// tests/login-json.spec.ts
+
+import { test, expect } from '@playwright/test';
+import { LoginPage } from '../../../pages/Login.Page';
+import testData from '../../../test-data/login-testdata.json';
+
+test.describe('SauceDemo Login Tests - JSON Data Driven', () => {
+  let loginPage: LoginPage;
+
+  test.beforeEach(async ({ page }) => {
+    loginPage = new LoginPage(page);
+    await loginPage.navigate();
+  });
+
+  test.describe('Successful Login Tests', () => {
+    for (const user of testData.validUsers) {
+      test(`should successfully login with ${user.description}`, async ({ page }) => {
+        // login with provided credentials
+        await loginPage.login(user.username, user.password);
+        await expect(loginPage.appLogo).toHaveText(user.expectedPostLogin.appLogoText);
+        await expect(page).toHaveURL(new RegExp(user.expectedPostLogin.urlPattern));
+      });
+    }
+  });
+});