Testing

npm run test:e2e

// playwright.config.ts
export default defineConfig({
  testDir: './e2e',
  workers: 1,                    // Serial execution (no parallelism)
  timeout: 90000,                // 90 seconds per test
  retries: 0,                    // Fail fast (no retries)
  reporter: 'list',              // Verbose console output
  use: {
    baseURL: 'http://127.0.0.1:4173',
    viewport: { width: 1280, height: 720 },
    colorScheme: 'dark',
    locale: 'en-US',
    timezoneId: 'UTC',
  },
  webServer: {
    command: 'VITE_E2E=1 npm run dev -- --host 127.0.0.1 --port 4173',
    url: 'http://127.0.0.1:4173/tests/map-harness.html',
    timeout: 120000,
  },
});

// e2e/runtime-fetch.spec.ts
import { test, expect } from '@playwright/test';

test('seismology API returns earthquakes', async ({ request }) => {
  const response = await request.get('/api/seismology/v1/list-earthquakes?min_magnitude=4.5&days=7');
  expect(response.status()).toBe(200);

  const data = await response.json();
  expect(data.earthquakes).toBeDefined();
  expect(Array.isArray(data.earthquakes)).toBe(true);
});

test('aviation API returns airport delays', async ({ request }) => {
  const response = await request.get('/api/aviation/v1/list-airport-delays');
  expect(response.status()).toBe(200);

  const data = await response.json();
  expect(data.delays).toBeDefined();
});

npm run test:e2e:full -- -g "seismology API"

npx playwright test --debug

npx playwright test --headed

// e2e/map-harness.spec.ts
test('matches golden screenshots per layer and zoom', async ({ page }) => {
  await page.goto('/tests/map-harness.html');

  // Test military bases layer at zoom 4
  await page.evaluate(() => {
    window.testHarness.setZoom(4);
    window.testHarness.toggleLayer('militaryBases', true);
  });
  await page.waitForTimeout(2000); // Wait for rendering
  await expect(page).toHaveScreenshot('military-bases-z4.png');

  // Test conflicts layer at zoom 6
  await page.evaluate(() => {
    window.testHarness.setZoom(6);
    window.testHarness.toggleLayer('conflicts', true);
  });
  await page.waitForTimeout(2000);
  await expect(page).toHaveScreenshot('conflicts-z6.png');
});

npm run test:sidecar

// api/_cors.test.mjs
import { test } from 'node:test';
import assert from 'node:assert';
import { getCorsHeaders, isDisallowedOrigin } from './_cors.js';

test('CORS allows worldmonitor.app', () => {
  const req = new Request('https://worldmonitor.app/api/test', {
    headers: { origin: 'https://worldmonitor.app' },
  });
  const headers = getCorsHeaders(req);
  assert.strictEqual(headers['Access-Control-Allow-Origin'], 'https://worldmonitor.app');
});

test('CORS blocks unknown origin', () => {
  const req = new Request('https://evil.com/api/test', {
    headers: { origin: 'https://evil.com' },
  });
  assert.strictEqual(isDisallowedOrigin(req), true);
});

npm run test:data

// tests/military-bases.test.mts
import { test } from 'node:test';
import assert from 'node:assert';
import { readFile } from 'node:fs/promises';

test('military bases GeoJSON is valid', async () => {
  const data = await readFile('./data/military-bases.geojson', 'utf-8');
  const geojson = JSON.parse(data);

  assert.strictEqual(geojson.type, 'FeatureCollection');
  assert(Array.isArray(geojson.features));

  for (const feature of geojson.features) {
    assert.strictEqual(feature.type, 'Feature');
    assert(feature.geometry);
    assert(feature.properties);
    assert(feature.properties.name);
  }
});

npm run test:feeds

// scripts/validate-rss-feeds.mjs
import { RSS_FEEDS } from './config/rss-feeds.js';

for (const feed of RSS_FEEDS) {
  const response = await fetch(feed.url, { timeout: 10000 });
  if (!response.ok) {
    console.error(`❌ ${feed.name}: HTTP ${response.status}`);
  } else {
    console.log(`✅ ${feed.name}`);
  }
}

# Full variant
npm run test:e2e:full -- -g "cluster movement cache"

# Tech variant
npm run test:e2e:tech -- -g "cluster movement cache"

# .github/workflows/test.yml
name: Test

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 18
      - run: npm ci
      - run: npm run typecheck
      - run: npm run test:data
      - run: npm run test:sidecar
      - run: npx playwright install chromium
      - run: npm run test:e2e

npx playwright show-trace trace.zip

test-results/
├── map-harness-matches-golden-chromium/
│   ├── test-failed-1.png
│   └── trace.zip

// playwright.config.ts
use: {
  video: 'retain-on-failure',
}