testing-editor-harness

Testing the editor E2E harness

Devin Secrets Needed

None.

Environment

• Work from frontend/packages/editor.
• Use Node 22.22.x and the pnpm fallback at /home/ubuntu/.local/bin/pnpm if mise/corepack is rate-limited.
• The harness uses Vite: pnpm test:harness runs vite --config e2e/vite.config.ts on http://localhost:5180.

Running the harness

export PATH="/home/ubuntu/.local/bin:/home/ubuntu/.local/share/mise/installs/node/22.22.0/bin:$PATH"
cd /home/ubuntu/repos/seed/frontend/packages/editor
pnpm test:harness

Open the browser at a real-mode fixture URL, e.g.:

http://localhost:5180/?real=1&fixture=allBlocks&badges=1

• real=1 mounts the actual DocumentEditor with a mock document machine.
• fixture=allBlocks renders one of every block type defined in e2e/test-app/TestEditor.tsx.
• badges=1 gives every fixture block a mock citation/comment count so supernumber badges render.

Mobile viewport emulation

The Chrome for Testing instance in this environment listens on remote-debugging port 29229. Use CDP to set a mobile viewport without keeping DevTools open:

// /tmp/set-mobile-viewport.js
const http = require('http');
const WebSocket = require('/home/ubuntu/repos/seed/node_modules/ws');

http.get('http://localhost:29229/json/list', (res) => {
  let data = '';
  res.on('data', (c) => (data += c));
  res.on('end', () => {
    const pages = JSON.parse(data);
    const page = pages.find((p) => p.type === 'page' && (p.url.includes('localhost:5180') || p.url === 'about:blank'));
    if (!page) { console.error('No suitable page found'); process.exit(1); }
    const ws = new WebSocket(page.webSocketDebuggerUrl);
    ws.on('open', () => {
      ws.send(JSON.stringify({id: 1, method: 'Page.navigate', params: {url: 'http://localhost:5180/?real=1&fixture=allBlocks&badges=1'}}));
      setTimeout(() => {
        ws.send(JSON.stringify({id: 2, method: 'Emulation.setDeviceMetricsOverride', params: {
          width: 390, height: 844, deviceScaleFactor: 2, mobile: true,
          screenWidth: 390, screenHeight: 844,
        }}));
        ws.send(JSON.stringify({id: 3, method: 'Emulation.setTouchEmulationEnabled', params: {enabled: true}}));
        setTimeout(() => ws.close(), 500);
      }, 300);
    });
  });
});