Modern Playwright-based API test suite for evaluating candidate submissions for the MetaPhoto Software Developer Technical Test.

This test suite validates Parts 1.1, 1.2, and 1.3 of the technical assessment using Playwright's powerful testing framework.

npm install

# Test local server (default: http://localhost:3001)
npm run test:local

# Test any deployed endpoint
BASE_URL=https://candidate-api.example.com npm test

# Test any URL
BASE_URL=https://your-api.com npx playwright test

npm run test:section:1.1   # Data Enrichment tests
npm run test:section:1.2   # Filtering tests
npm run test:section:1.3   # Pagination tests

# Open Playwright UI for interactive testing
npm run test:local:ui

# Debug mode (step through tests)
npm run test:debug

# Show HTML report after running tests
npm run test:report

The test suite automatically detects the API endpoint path from these options:

1. /v1/api/photos
2. /externalapi/photos
3. /api/photos
4. /photos

tests/
├── fixtures.ts                    # Shared test fixtures and types
├── global-setup.ts                # API path detection
├── section-1.1-enrichment.spec.ts # Data enrichment tests
├── section-1.2-filtering.spec.ts  # Filtering tests
└── section-1.3-pagination.spec.ts # Pagination tests

• Photo base fields (id, title, url, thumbnailUrl)
• Nested album with correct id and title
• Nested user with complete data
• User address and company details
• Clean response (no albumId at root)
• Error handling (404, 400)

• Title filter (contains) - exact IDs: 13, 260, 318, 577
• Album title filter (contains) - 100 photos
• User email filter (equals) - 500 photos
• Case insensitivity
• Combined filters (AND logic)
• Edge cases (empty results, unknown params)

• Default limit=25, offset=0
• Custom limit values
• Offset functionality
• Pagination with filters
• Edge cases (beyond results, invalid values)

Running 46 tests using 1 worker

  Section 1.1: Data Enrichment API (20 points)
    GET /photos/:id - Photo Enrichment
      ✓ returns enriched photo with correct base fields
      ✓ includes nested album with correct id and title
      ✓ includes nested user under album with complete data
      ✓ includes user address details
      ✓ includes user company details
      ✓ removes albumId from root level (clean response)
      ...

  46 passed (12.5s)

- name: Run API Tests
  env:
    BASE_URL: ${{ secrets.API_URL }}
  run: npx playwright test
  
- name: Upload Test Report
  uses: actions/upload-artifact@v3
  if: always()
  with:
    name: playwright-report
    path: playwright-report/

After running tests, reports are available in:

• playwright-report/ - HTML report
• test-results/results.json - JSON results

• Auto-detects API path — works with different URL structures
• 46 comprehensive test cases across all sections
• TypeScript support — full type safety
• Interactive UI mode — visual test debugging
• HTML reports — detailed test results
• Parallel execution — fast test runs
• CI/CD ready — GitHub Actions compatible

ISC