Files
Sable/tests/e2e

End-to-end tests

Playwright drives the real app (vite dev on :8080) against a throwaway Continuwuity homeserver started per run. The suite covers functional flows (login, sync, navigation, timeline) and captures screenshots for layout regression.

Requirements

  • Docker running (a Continuwuity container is started via testcontainers).

Running

pnpm test:e2e                  # functional tests on the host (screenshots skipped)
pnpm test:e2e:docker           # full suite, browser in the pinned container
pnpm test:e2e:docker:update    # regenerate screenshot baselines
pnpm test:e2e:ui               # interactive UI mode
pnpm test:e2e:report           # open the last HTML report

Screenshot baselines are rendered in mcr.microsoft.com/playwright:<version>-noble, because font rendering differs between hosts. Regenerate them with test:e2e:docker:update, never on the host. Visual tests skip unless PW_TEST_CONNECT_WS_ENDPOINT is set.

How it works

global-setup.ts:

  1. Starts a Continuwuity container with open registration.
  2. Registers a user and seeds deterministic rooms/messages over the client-server API.
  3. Injects the session into the app's localStorage (matrixSessions + matrixActiveSession) and saves it as Playwright storageState, so specs start already logged in without driving the login UI.

The container is stopped in the returned teardown.

Adding a test

Specs live in tests/e2e/*.spec.ts and run against both a desktop and a mobile viewport. Assert behaviour with locators; add toHaveScreenshot where a layout baseline is useful. Screenshot baselines live in tests/e2e/__screenshots__.

Notes when adding screenshots:

  • Mask dynamic content (time elements, the room-intro creation line).
  • The message timeline is virtualised, so its item positions shift between runs; snapshot the surrounding layout rather than the timeline itself.
  • folds renders Text as p, so getByRole('heading') will not match titles.