create-regression-test

Create Regression / Smoke Test

Generate a complete test spec with associated test data and fixture integration.

Workflow

1. Determine the feature name from the user's request
2. Determine the suite — regression (default) or smoke
3. Check if a POM exists in e2e/poms/{feature}.page.ts
   • If yes, read its public methods and JSDoc to understand available actions
   • If no, create one first using the create-pom skill
4. Check if test data exists in e2e/test-data/{feature}.json
   • If yes, read and use the existing data shape
   • If no, create the JSON file with template data
5. Check fixtures in e2e/fixtures/base.ts
   • If the feature is not yet registered, add the interface and loader
6. Create the spec file in the appropriate directory
7. Run the test to verify it passes:

   npx playwright test --project="chromium:regression" {feature}.spec.ts
   

Spec File Structure

Every spec follows this exact pattern:

import { test } from '../../fixtures/base';
import { getAuthFilePath } from '../../helpers/env-config';
import { FeaturePage } from '../../poms/feature.page';

const authFile = getAuthFilePath();

test.describe('Feature Name Tests', () => {
    // One-time setup: clean stale data from previous failed runs
    test.beforeAll(async ({ browser }) => {
        const context = await browser.newContext({
            storageState: authFile,
        });
        const page = await context.newPage();
        const pom = new FeaturePage(page);
        await pom.setUp();
        await page.close();
        await context.close();
    });

    test('should create a new item', async ({ page, testData }) => {
        const pom = new FeaturePage(page);
        const item = testData.feature.items[0];

        await pom.navigateToPage();
        await pom.createItem(item.name, item.value);
        await pom.verifyItemExists(item.name);
    });

    test('should edit an existing item', async ({ page, testData }) => {
        const pom = new FeaturePage(page);
        const item = testData.feature.items[0];
        const updated = testData.feature.updatedItem;

        await pom.navigateToPage();
        await pom.createItem(item.name, item.value);
        await pom.editItem(item.name, updated.name, updated.value);
        await pom.verifyItemExists(updated.name);
    });

    test('should delete an item', async ({ page, testData }) => {
        const pom = new FeaturePage(page);
        const item = testData.feature.items[1];

        await pom.navigateToPage();
        await pom.createItem(item.name, item.value);
        await pom.deleteItem(item.name);
        await pom.verifyItemNotExists(item.name);
    });
});