e2e-test/ui/playwright/
├── playwright.config.ts          # Playwright configuration
├── fixtures/                     # Modular test fixtures (composed via mergeTests)
│   ├── base-test.ts              # Import for authenticated tests (most tests)
│   ├── login-test.ts             # Import for login UI tests (unauthenticated)
│   ├── login.fixture.ts          # Per-worker auth state management
│   ├── logger.fixture.ts         # Winston logger (auto-injected into every test)
│   ├── mocking.fixture.ts        # apiMock fixture for route interception
│   ├── seeding.fixture.ts        # Per-worker test data injection (seedingFixture)
│   └── login.ts                  # Auth file path helpers + GMS token reader
├── pages/                        # Page Object Models
│   ├── base.page.ts              # Base class: screenshot helper, logger/logDir
│   ├── login.page.ts
│   ├── search.page.ts
│   ├── dataset.page.ts
│   ├── business-attribute.page.ts
│   ├── welcome-modal.page.ts
│   ├── incidents.page.ts
│   └── common/
│       ├── searchbar-component.ts
│       └── sidebar-component.ts
├── tests/                        # Test specs, organised by feature
│   ├── auth/
│   ├── login-v2/
│   ├── onboarding/
│   ├── search/
│   ├── business-attributes/
│   └── incidents-v2/
├── helpers/                      # Standalone utility classes
│   ├── cleanup-helper.ts         # CleanupHelper / GlobalCleanupHelper
│   ├── graphql-helper.ts         # GraphQL request helpers (executeQuery, waitForGraphQLResponse)
│   ├── seeder-utils.ts           # Shared extractUrn + waitForSync utilities
│   ├── wait-helper.ts            # Wait strategies
│   └── seeders/                  # Seeder implementations (see seeders/README.md)
│       ├── cli-seeder.ts         # Seed via DataHub CLI (requires datahub CLI on $PATH)
│       ├── graphql-seeder.ts     # Seed via GraphQL API
│       └── rest-seeder.ts        # Seed via GMS REST API
├── factories/                    # Data generation
│   ├── test-data-factory.ts      # URN builders + timestamped name generators
│   ├── mock-response-factory.ts  # Re-exports from mock-responses/ (backward compat)
│   └── mock-responses/           # Per-API GraphQL mock response builders
│       ├── common.ts             # Shared types + generic error/success builders
│       ├── search.ts             # Search response builders
│       ├── dataset.ts            # Dataset response builders
│       └── index.ts              # Barrel re-export
├── data/
│   └── users.ts                  # Test user definitions (users)
└── utils/                        # Shared constants and utilities
    ├── constants.ts              # Timeouts, routes, entity types, data sources
    ├── cleanup.ts                # ScopedCleanup + deleteEntities helpers
    ├── test-data.ts              # RestFeatureDataLoader for on-demand data injection
    ├── logger.ts                 # createLogger factory (Winston)
    ├── api-mock.ts               # PageApiMocker class
    └── random.ts                 # withTimestamp, withRandomSuffix helpers

cd e2e-test/ui/playwright
yarn install
yarn playwright install chromium

# All tests
yarn playwright test

# Headed (see browser)
yarn playwright test --headed

# Interactive UI mode
yarn playwright test --ui

# Debug mode (step through)
yarn playwright test --debug

# Specific suite
yarn playwright test tests/search/
yarn playwright test tests/business-attributes/

# Specific test file
yarn playwright test tests/search/search-filters.spec.ts

# Specific test by name
yarn playwright test --grep "should login successfully"

# View HTML report after a run
yarn playwright show-report

import { test, expect } from '../../fixtures/base-test';
import { SearchPage } from '../../pages/search-page';

test.describe('Search', () => {
  let searchPage: SearchPage;

  test.beforeEach(async ({ page, logger, logDir }) => {
    searchPage = new SearchPage(page, logger, logDir);
    await searchPage.navigateToHome();
  });

  test('should return results for wildcard query', async () => {
    await searchPage.searchAndWait('*', 3000);
    await searchPage.expectHasResults();
  });
});

import { test, expect } from '../../fixtures/login-test';

test.describe('Login', () => {
  test('should reject invalid credentials', async ({ loginPage }) => {
    await loginPage.navigateToLogin();
    await loginPage.login('bad', 'creds');
    await loginPage.expectLoginError();
  });
});

import { test, expect } from '../../fixtures/base-test';

test('renders with feature flag enabled', async ({ page, apiMock }) => {
  await apiMock.setFeatureFlags({ themeV2Enabled: true });
  await page.goto('/');
  // ...
});

import { test } from '../../fixtures/base-test';
import { users } from '../../fixtures/users';

test.use({ user: users.reader });

test('reader cannot edit', async ({ page }) => {
  /* ... */
});

import { Page, Locator } from '@playwright/test';
import { BasePage } from './base-page';
import { DataHubLogger } from '../utils/logger';

export class FeaturePage extends BasePage {
  readonly submitButton: Locator;

  constructor(page: Page, logger?: DataHubLogger, logDir?: string) {
    super(page, logger, logDir);
    this.submitButton = page.locator('[data-testid="feature-submit"]');
  }

  async submit(): Promise<void> {
    await this.submitButton.click();
  }
}

import { test, expect } from '../../fixtures/base-test';

// Set at file/describe level — seeds from tests/search/fixtures/data.json
test.use({ featureName: 'search' });

test.describe('Search', () => {
  test('results exist', async ({ page }) => {
    // Data is guaranteed to be present
  });
});

tests/{featureName}/fixtures/data.json   ← MCP array (proposedSnapshot format)
.seeded/{featureName}.json               ← auto-generated state file (gitignored)

PW_NO_SEED=1 npx playwright test

rm -rf .seeded/

import { TestDataFactory } from '../../factories/test-data-factory';

const name = TestDataFactory.generateTestDatasetName();
// → 'test_dataset_20260409_143022'

const urn = TestDataFactory.createDatasetUrn('hive', name);
// → 'urn:li:dataset:(urn:li:dataPlatform:hive,test_dataset_20260409_143022,PROD)'

import { createSearchResponse } from '../../factories/mock-responses/search';
import { createErrorResponse } from '../../factories/mock-responses/common';

const ok = createSearchResponse([], 0);
// → { status: 200, body: { data: { search: { searchResults: [], total: 0 } } } }

const err = createErrorResponse('not found', 'NOT_FOUND');
// → { status: 200, body: { errors: [{ message: "not found", ... }] } }

import { CleanupHelper } from '../../helpers/cleanup-helper';

test.afterAll(async ({ page }) => {
  const cleanup = new CleanupHelper(page);
  await cleanup.deleteEntities(createdUrns);
});