mirror of https://github.com/danny-avila/LibreChat.git synced 2026-06-24 16:36:14 +00:00

History

Danny Avila d680763db3 Some checks are pending 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 🧭 ci: Use System Chrome for Mock E2E (#13481 )		2026-06-02 22:07:10 -04:00
..
config	🎭 feat: Add Credential-Free Playwright Smoke Suite with a Local Mock LLM (#13472 )	2026-06-02 16:36:39 -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	🧭 ci: Use System Chrome for Mock E2E (#13481 )	2026-06-02 22:07:10 -04:00
specs	🎭 feat: Add Credential-Free Playwright Smoke Suite with a Local Mock LLM (#13472 )	2026-06-02 16:36:39 -04:00
config.local.example.ts	🤲 feat(a11y): Initial a11y improvements, added linters, tests; fix: close sidebars in mobile view (#3536 )	2024-08-04 20:39:52 -04:00
jestSetup.js	✨ v0.8.6 (#13302 )	2026-05-31 17:36:47 -04:00
playwright.config.a11y.ts	⚖️ feat: Add Violation Scores (#8304 )	2025-07-07 17:08:40 -04:00
playwright.config.local.ts	🛟 test: Restore Playwright Smoke E2E (#13020 )	2026-05-14 09:49:26 -04:00
playwright.config.mock.ts	🧭 ci: Use System Chrome for Mock E2E (#13481 )	2026-06-02 22:07:10 -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	🎭 feat: Add Credential-Free Playwright Smoke Suite with a Local Mock LLM (#13472 )	2026-06-02 16:36:39 -04:00
types.ts	🤲 feat(a11y): Initial a11y improvements, added linters, tests; fix: close sidebars in mobile view (#3536 )	2024-08-04 20:39:52 -04:00

README.md

LibreChat e2e

The mock e2e profile is the safest default for generated tests. It starts LibreChat with e2e/config/librechat.e2e.yaml, points custom endpoints at the local mock LLM server, 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 mock LLM and LibreChat test server 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 LLM 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.