mirror of https://github.com/danny-avila/LibreChat.git synced 2026-06-10 01:44:44 +00:00

History

Danny Avila 2a956f143d Some checks are pending Docker Dev Images Build / build (Dockerfile, librechat-dev, node) (push) Waiting to run Details Docker Dev Images Build / build (Dockerfile.multi, librechat-dev-api, api-build) (push) Waiting to run Details GitNexus Index / index (push) Waiting to run Details GitNexus Index / post-index (push) Blocked by required conditions Details Sync Locize Translations & Create Translation PR / Sync Translation Keys with Locize (push) Waiting to run Details Sync Locize Translations & Create Translation PR / Create Translation PR on Version Published (push) Blocked by required conditions Details Sync Helm Chart Tags / Ignore non-main push (push) Waiting to run Details Sync Helm Chart Tags / Sync chart tags (push) Waiting to run Details 🪞 fix: Preserve Model Spec Icons Across Stream Resume and Abort (#13603 )		2026-06-08 17:14:21 -04:00
..
config	🪞 fix: Preserve Model Spec Icons Across Stream Resume and Abort (#13603 )	2026-06-08 17:14:21 -04:00
fixtures/deployment-skills/e2e-deployment-skill	🗂️ feat: Add Deployment Skill Directory (#13523 )	2026-06-05 10:24:28 -04:00
recordings	🎭 feat: Add Credential-Free Playwright Smoke Suite with a Local Mock LLM (#13472 )	2026-06-02 16:36:39 -04:00
setup	🪞 fix: Preserve Model Spec Icons Across Stream Resume and Abort (#13603 )	2026-06-08 17:14:21 -04:00
specs	🪞 fix: Preserve Model Spec Icons Across Stream Resume and Abort (#13603 )	2026-06-08 17:14:21 -04:00
config.local.example.ts
jestSetup.js
playwright.config.a11y.ts
playwright.config.local.ts
playwright.config.mock.ts	🗂️ feat: Add Deployment Skill Directory (#13523 )	2026-06-05 10:24:28 -04:00
playwright.config.ts	🎭 feat: Add Credential-Free Playwright Smoke Suite with a Local Mock LLM (#13472 )	2026-06-02 16:36:39 -04:00
README.md	🎭 test: Run Mock E2E Suite Through `createRun` With In-Process Fake Model (#13508 )	2026-06-04 08:33:28 -04:00
types.ts

README.md

LibreChat e2e

The mock e2e profile is the safest default for generated tests. It starts LibreChat with e2e/config/librechat.e2e.yaml, injects an in-process fake LLM (via LIBRECHAT_TEST_RUN_HOOK), creates an authenticated e2e user, and avoids real provider credentials.

Recording Tests

Use Playwright codegen when you want to turn an exploratory browser session into a draft test:

npm run e2e:record

That command builds the app, starts the LibreChat test server (with an in-process fake LLM) when needed, writes e2e/storageState.json, and opens Playwright codegen at /c/new. The npm script uses http://localhost:3333 so it does not collide with a normal dev server on 3080. Raw recordings are written to e2e/recordings/ and ignored by git.

For a real local LibreChat config instead of the mock profile:

npm run e2e:record:local

Useful direct options:

node e2e/setup/record.js --url=http://localhost:3080/c/new
node e2e/setup/record.js --profile=local --no-output
node e2e/setup/record.js --auth-only
node e2e/setup/record.js --output=e2e/recordings/settings-draft.spec.ts

LLM-Assisted Loop

Start npm run e2e:record.
Let the LLM use Computer Use to operate the headed Playwright browser.
Stop codegen after the workflow is captured.
Move the useful parts from e2e/recordings/ into a committed spec under e2e/specs/mock/.
Replace brittle generated selectors with role, label, text, or data-testid locators.
Add assertions that prove the behavior, not just the clicked path.
Run the finished spec with npm run e2e:mock -- <spec name>.

Generated recordings are a draft, not the final test. The committed version should use the shared helpers in e2e/specs/mock/helpers.ts where possible, wait on network or visible UI state instead of fixed sleeps, and keep test data deterministic.