Playwright Runner Gearbox

import { test, expect } from '@playwright/test';
 
test.describe('Enrolment', () => {
  test.beforeAll(async () => { /* once per worker for this group */ });
 
  test.beforeEach(async ({ page }) => {
    await page.goto('/batches');
  });
 
  test('learner can reserve a seat', { tag: '@sanity' }, async ({ page }) => {
    await page.getByRole('link', { name: 'Playwright with TypeScript' }).click();
    await page.getByRole('button', { name: 'Reserve seat' }).click();
    await expect(page.getByRole('status')).toHaveText('Seat reserved');
  });
 
  test.afterEach(async ({ page }, testInfo) => {
    if (testInfo.status !== testInfo.expectedStatus) {
      await testInfo.attach('failure-view', {
        body: await page.screenshot(), contentType: 'image/png',
      });
    }
  });
});

// kit/awu-test.ts
import { test as base } from '@playwright/test';
import { SignInScreen } from '../screens/SignInScreen';
import { LearnerHomeScreen } from '../screens/LearnerHomeScreen';
 
type AwuKit = {
  signInScreen: SignInScreen;
  learnerHome: LearnerHomeScreen;     // arrives already signed in
};
 
export const test = base.extend<AwuKit>({
  signInScreen: async ({ page }, use) => {
    await use(new SignInScreen(page));
  },
  learnerHome: async ({ page }, use) => {
    const signIn = new SignInScreen(page);
    await signIn.visit();
    await signIn.enterPortal('priya.k@awu.test', process.env.AWU_SECRET!);
    await use(new LearnerHomeScreen(page));   // the test body runs here
    // code after use() = cleanup
  },
});
export { expect } from '@playwright/test';

import { test, expect } from '../kit/awu-test';
 
test('learner home lists enrolled batches', async ({ learnerHome }) => {
  await expect(learnerHome.batchTiles).toHaveCount(2);
});

// specs/session.setup.ts
import { test as setup, expect } from '@playwright/test';
const stateFile = '.awu-session/learner-state.json';
 
setup('sign in once and keep the cookies', async ({ page }) => {
  await page.goto('/sign-in');
  await page.getByLabel('Learner email').fill('priya.k@awu.test');
  await page.getByLabel('Account password').fill(process.env.AWU_SECRET!);
  await page.getByRole('button', { name: 'Continue to portal' }).click();
  await expect(page).toHaveURL(/learner-home/);
  await page.context().storageState({ path: stateFile }); // cookies + localStorage
});

projects: [
  { name: 'awu-session', testMatch: /.*\.setup\.ts/ },
  { name: 'desktop-chrome', dependencies: ['awu-session'],
    use: { ...devices['Desktop Chrome'], storageState: '.awu-session/learner-state.json' } },
  { name: 'desktop-edge', dependencies: ['awu-session'],
    use: { ...devices['Desktop Edge'], channel: 'msedge', storageState: '.awu-session/learner-state.json' } },
  { name: 'android-pixel', dependencies: ['awu-session'],
    use: { ...devices['Pixel 7'], storageState: '.awu-session/learner-state.json' } },
],

export default defineConfig({
  fullyParallel: true,
  workers: process.env.CI ? 3 : undefined,
  retries: process.env.CI ? 1 : 0,
  maxFailures: process.env.CI ? 10 : 0,
});

reporter: [
  ['line'],
  ['html', { open: 'never', outputFolder: 'awu-reports/html' }],
  ['junit', { outputFile: 'awu-reports/junit-results.xml' }],
  ['allure-playwright'],
],

test('pay batch fee via UPI', { tag: ['@payments', '@nightly'] }, async ({ page }) => { /* ... */ });
test.describe('Wishlist', { tag: '@sanity' }, () => { /* every test inside inherits @sanity */ });

const plans = [
  { plan: 'self-paced', fee: '₹2,499', liveDoubts: false },
  { plan: 'live-batch', fee: '₹4,999', liveDoubts: true },
  { plan: 'mentorship', fee: '₹9,999', liveDoubts: true },
];
 
for (const p of plans) {
  test(`pricing card for ${p.plan}`, async ({ page }) => {
    await page.goto('/pricing');
    const card = page.getByTestId(`plan-${p.plan}`);
    await expect(card).toContainText(p.fee);
    await expect(card.getByText('Live doubt sessions')).toBeVisible({ visible: p.liveDoubts });
  });
}

npx playwright test --shard=1/3     # runner 1
npx playwright test --shard=2/3     # runner 2
npx playwright test --shard=3/3     # runner 3
npx playwright merge-reports --reporter html ./collected-blobs

name: awu-regression
on:
  push: { branches: [main] }
  workflow_dispatch:
jobs:
  e2e:
    runs-on: ubuntu-latest
    strategy:
      fail-fast: false
      matrix:
        shardIndex: [1, 2, 3]
        shardTotal: [3]
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: 22 }
      - run: npm ci
      - run: npx playwright install --with-deps
      - run: npx playwright test --shard=${{ matrix.shardIndex }}/${{ matrix.shardTotal }} --reporter=blob
      - uses: actions/upload-artifact@v4
        if: always()
        with:
          name: awu-blob-${{ matrix.shardIndex }}
          path: blob-report/

import { defineConfig, devices } from '@playwright/test';
 
export default defineConfig({
  testDir: './specs',
  outputDir: './test-output',
  timeout: 45_000,
  expect: { timeout: 7_000 },
  fullyParallel: true,
  forbidOnly: !!process.env.CI,
  retries: process.env.CI ? 1 : 0,
  workers: process.env.CI ? 3 : undefined,
  reporter: [['line'], ['html', { open: 'never', outputFolder: 'awu-reports/html' }]],
  use: {
    baseURL: process.env.AWU_BASE_URL ?? 'https://qa.awu-portal.test',
    trace: 'retain-on-failure',
    screenshot: 'only-on-failure',
    video: 'on-first-retry',
  },
  projects: [
    { name: 'awu-session', testMatch: /.*\.setup\.ts/ },
    { name: 'desktop-chrome', dependencies: ['awu-session'], use: { ...devices['Desktop Chrome'] } },
  ],
});