testing-library/user-event

Health v2 · maintenance only

Adoption not part of the score

2323 stars · 256 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

user-event is a companion library for Testing Library that simulates real user interactions with the DOM by dispatching the full sequence of events a browser would fire for actions like clicking, typing, and uploading files. It provides higher-level interaction APIs than raw fireEvent, including visibility and interactability checks, making component tests behave more like real user sessions in jsdom or happy-dom environments.

Use cases

• simulate user typing and clicking in jsdom tests
• test react components with realistic user interactions
• fire full browser event sequences instead of single dom events
• test keyboard input including modifier keys and key sequences
• simulate file uploads and clipboard interactions in tests
• write user-centric tests for frontend ui components
• test that hidden or disabled elements reject interactions like a real browser

When to choose

• you are writing Testing Library component tests that run in jsdom or happy-dom
• you need realistic multi-event interactions like focus-then-type instead of raw fireEvent calls
• you want built-in checks that prevent interacting with hidden or disabled elements
• you need to simulate keyboard, pointer, clipboard, and upload workflows in unit tests

When to avoid

• your tests can run in a real browser - prefer Vitest Browser Mode or Playwright instead
• you are writing end-to-end tests where Playwright's auto-waiting locator actions are a better fit
• you need to dispatch a single specific DOM event that user-event does not implement
• you need layout-aware pointer testing since jsdom has no layout and positions are not simulated

Facets

library · maturity active

testing e2e-testing mocking testing frontend web-development developer-tools browser cross-platform dom-testing user-interaction-simulation testing-library jsdom happy-dom jest vitest event-dispatching ui-testing component-testing nodejs

Member repositories

For agents

markdown · JSON · MCP: product_card(name="testing-library/user-event")