Back to Explore

testing-library/user-event

GitHub
1 watchersOpen source

Last release: 1/21/2025

user-event is a testing utility that simulates real browser user actions by firing events in the same way a user interacts with the page. It is useful for writing higher-level UI tests where actions like userEvent.click update element state similarly to actual user behavior, compared to lower-level fireEvent usage.

Project status

  • The repository appears actively maintained, with a recent upstream push on 2025-08-25, and tagged updates in January 2025 (v14, v14.6, v14.6.1).
  • Update cadence suggests ongoing development, with multiple version tags created on 2025-01-21 (v14, then v14.6, then v14.6.1 shortly after). Beyond that, the provided data is too limited to infer a steady monthly or quarterly rhythm.

AI summary generated Today

AI-generated from public sources. May be inaccurate. Report

Recent updates

  • v14.6.1

    1/21/2025

    user-event v14.6.1 is a bug-fix release focused on keyboard navigation defaults, pointer event fidelity, and upload file acceptance behavior. No breaking API changes are noted in the release notes, but several fixes may alter how events are synthesized and dispatched in edge cases.

  • v14.6

    1/21/2025

    The publisher provided release notes as empty, so there is no documented information about changes included in v14.6. As a result, developers should review the actual code changes (commit diffs and release tags) before upgrading to identify any undocumented breaking changes or behavior modifications.

  • v14

    1/21/2025

    This release is labeled v14, but no release notes were provided by the publisher. As a result, no specific details are available about new functionality, bug fixes, security updates, or breaking changes.

  • v14.6.0

    1/15/2025

    v14.6.0 focuses on improving event simulation fidelity. It adds support for dispatching FocusEvent-related events when the document is hidden, and includes fixes around clipboard data transfer and more accurate pointer coordinate handling.

    Features

  • v14.5.2

    12/29/2023

    v14.5.2 primarily removes interop glue code and deep imports from @testing-library/dom, switching to direct imports (getConfig) instead. Alongside that, the event infrastructure was refactored, including changes to how event types and default event initialization are derived.

  • v14.5.1

    9/15/2023

    v14.5.1 is a small patch release with a bug fix related to how @testing-library/dom is imported. Specifically, it adjusts the interop layer to avoid relying on a default export and instead uses named/namespace imports consistently.

  • v14.5.0

    9/14/2023

    v14.5.0 primarily improves the public export surface by adding a named export for `userEvent` and expanding exported TypeScript types. The release notes only mention export and typing changes, but the code diff also includes internal refactors around how `@testing-library/dom` utilities are imported and how the base event map is wired.

    Features

  • v14.4.3

    8/9/2022

    v14.4.3 release notes only mention two fixes: adding a `types` field to package `exports`, and removing circular dependencies. The actual diff is much broader, showing a refactor of the internal instance/config wiring and a large reorganization of the document UI tracking and event dispatch modules.

  • v14.4.2

    8/4/2022

    Release v14.4.2 contains a small set of changes with no obvious runtime behavior updates shown in the provided diff. The release notes mention a build-related change to add an `exports` field, but the visible code changes instead focus on contributor metadata and a devDependency version bump.

  • v14.4.1

    8/2/2022

    Release v14.4.1 is described as a build-related bug fix, specifically transpiling to ES2019 syntax. The code diff shows build tooling changes plus documentation-only updates to contributor lists.

  • v14.4.0

    8/2/2022

    v14.4.0 adds pointer support for dispatching auxclick events and includes multiple robustness fixes across pointer, keyboard, and upload behaviors. The release notes focus on event behavior correctness (modifier handling for keyboard, pointer event details, and robustness for incomplete DOM APIs). The code diff also shows a much larger internal refactor around event construction and a new system abstraction for keyboard and pointer.

    Features

  • v14.3.0

    7/19/2022

    v14.3.0 adds keyboard navigation for radio groups so arrow-key interactions move focus and activate different radios within the same group. The implementation introduces a new internal utility and modifies the keydown behavior for arrow keys on radio inputs.

    Features