clj-e2e/README.md

Rama master · réplica de lectura del repositorio original.

# e2e

e2e tests for Logseq app.

## Prerequisites

* The app's JS and CSS assets are built and located at `../static/`.
* [Babashka](https://github.com/babashka/babashka) is installed.

## Setup

Serve the static assets (default port 3002):

    $ bb serve

To use a custom port:

    $ bb serve --port 3001
    $ bb serve -p 3001

If `pnpm watch` is already running, skip `bb serve`: shadow-cljs's dev-http
already serves the desktop app from `../static/` on port 3001, so run tests
with `bb test -p 3001 ...`.

## Running Tests

Run all tests (namespaces ending in `-basic-test`):

    $ bb test

Run a single test namespace:

    $ bb test -n logseq.e2e.editor-basic-test

Run a single test function:

    $ bb test -v logseq.e2e.editor-basic-test/toggle-between-page-and-block

Filter by metadata tag (e.g. `^:focus`):

    $ bb test -i focus

Combine namespace and tag filters:

    $ bb test -n logseq.e2e.editor-basic-test -i focus

Run tests against a custom port:

    $ bb test -p 3001

Run tests and serve together (starts both in parallel):

    $ bb dev
    $ bb dev -p 3001

## How `-i` Works

The `-i`/`--include` flag is a [cognitect test-runner](https://github.com/cognitect-labs/test-runner) option. It filters tests by Clojure metadata key. Add `^:focus` to any `deftest` and pass `-i focus` to run only those tests:

```clojure
(deftest ^:focus my-test
  ...)
```

## RTC Tests

RTC tests sync against a **local db-sync server** (the deps/db-sync node
adapter), not api.logseq.io. The test JVM starts the server itself through
`cli-e2e/scripts/db_sync_server.py` on a free port and injects a local test
account — no Cognito login, no network access to production sync. The server
runs with `DB_SYNC_ALLOW_UNVERIFIED_JWT_CLAIMS=true` and a dead JWKS URL, so
it accepts the test JWT's unverified claims.

Prerequisite: build the node adapter once (also rebuild when deps/db-sync
changes):

    $ pnpm --dir deps/db-sync install --frozen-lockfile --ignore-workspace
    $ pnpm --dir deps/db-sync build:node-adapter

Run RTC extra tests (served + tested in parallel):

    $ bb run-rtc-extra-test
    $ bb run-rtc-extra-part2-test

## Debugging

When tests fail, `clj-e2e/e2e-dump/` contains console logs and screenshots.