# user-event changelog

> Simulates real user interaction for tests, above raw DOM events.

- Vendor: Testing Library
- Category: Developer Tools
- Official site: https://testing-library.com/docs/user-event/intro
- Tracked by: What's New (https://whatsnew.fyi/product/testing-library-user-event)
- Harvested from: GitHub (testing-library/user-event)
- Entries below: 10 (newest first)

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

## Releases

### v14.6.5

- Date: 2026-08-18
- Version: v14.6.5
- Original notes: https://github.com/testing-library/user-event/releases/tag/v14.6.5
- Permalink: https://whatsnew.fyi/product/testing-library-user-event/releases/v14.6.5

- **fixed** — tab retargeting if focus moved during keydown

##### [14.6.5](https://github.com/testing-library/user-event/compare/v14.6.4...v14.6.5) (2026-08-18)


###### Bug Fixes

* tab retargeting if focus moved during keydown ([#1296](https://github.com/testing-library/user-event/issues/1296)) ([43efda7](https://github.com/testing-library/user-event/commit/43efda7f998c3e519cb1c5ced2795a459c0f0f65))

### v14.6.4

- Date: 2026-08-11
- Version: v14.6.4
- Original notes: https://github.com/testing-library/user-event/releases/tag/v14.6.4
- Permalink: https://whatsnew.fyi/product/testing-library-user-event/releases/v14.6.4

- **fixed** — keyboard event repeat property

##### [14.6.4](https://github.com/testing-library/user-event/compare/v14.6.3...v14.6.4) (2026-08-11)


###### Bug Fixes

* keyboard event repeat property ([#1312](https://github.com/testing-library/user-event/issues/1312)) ([d7e80e3](https://github.com/testing-library/user-event/commit/d7e80e33366e8f64d9a3bf4b012b5720c9fcc0e7))

### v14.6.3

- Date: 2026-08-03
- Version: v14.6.3
- Original notes: https://github.com/testing-library/user-event/releases/tag/v14.6.3
- Permalink: https://whatsnew.fyi/product/testing-library-user-event/releases/v14.6.3

- **fixed** — Manually release a patch version

##### [14.6.3](https://github.com/testing-library/user-event/compare/v14.6.2...v14.6.3) (2026-08-03)


###### Bug Fixes

* **release:** manually release a patch version ([#1321](https://github.com/testing-library/user-event/issues/1321)) ([1d18b1f](https://github.com/testing-library/user-event/commit/1d18b1fae589eeed8e08838672a4c2de0dcc2b36)), closes [#1317](https://github.com/testing-library/user-event/issues/1317)

### v14.6.2

- Date: 2026-08-03
- Version: v14.6.2
- Original notes: https://github.com/testing-library/user-event/releases/tag/v14.6.2
- Permalink: https://whatsnew.fyi/product/testing-library-user-event/releases/v14.6.2

##### [14.6.2](https://github.com/testing-library/user-event/compare/v14.6.1...v14.6.2) (2026-08-03)

### v14.6.1

- Date: 2025-01-21
- Version: v14.6.1
- Original notes: https://github.com/testing-library/user-event/releases/tag/v14.6.1
- Permalink: https://whatsnew.fyi/product/testing-library-user-event/releases/v14.6.1

- **fixed** — correct description for delay option
- **fixed** — add ContextMenu to defaultKeyMap
- **fixed** — add brackets to defaultKeyMap
- **fixed** — walk through radio group per arrow keys
- **fixed** — dispatch mouse events if pointerdown is defaultPrevented
- **fixed** — set button and buttons properties on PointerEvent
- **fixed** — use 1 as default value for PointerEvent.width and PointerEvent.height
- **fixed** — prevent click event loop on form-associated custom element
- **fixed** — prevent click event on non-focusable control
- **fixed** — apply accept filter more leniently in upload

##### [14.6.1](https://github.com/testing-library/user-event/compare/v14.6.0...v14.6.1) (2025-01-21)

###### Bug Fixes

* correct description for `delay` option ([#1175](https://github.com/testing-library/user-event/issues/1175)) ([2edf14d](https://github.com/testing-library/user-event/commit/2edf14d2e787e5a4217e69f602d21dc9dc8a6149))
* **keyboard:** add `ContextMenu` to `defaultKeyMap` ([#1079](https://github.com/testing-library/user-event/issues/1079)) ([3e471d1](https://github.com/testing-library/user-event/commit/3e471d1feb2ab08c34650a9d51b4b29555122663))
* **keyboard:** add brackets to `defaultKeyMap` ([#1226](https://github.com/testing-library/user-event/issues/1226)) ([543ecb0](https://github.com/testing-library/user-event/commit/543ecb0ea91ce36de9ed9d4f0fffc43df0068f38))
* **keyboard:** walk through radio group per arrow keys ([#1049](https://github.com/testing-library/user-event/issues/1049)) ([bf8111c](https://github.com/testing-library/user-event/commit/bf8111ca9fed2ab738e0568d741c2de1425e0ca4))
* **pointer:** dispatch mouse events if `pointerdown` is `defaultPrevented` ([#1121](https://github.com/testing-library/user-event/issues/1121)) ([f681f7b](https://github.com/testing-library/user-event/commit/f681f7bbfe4938540d4f2504d32e7f45b3ab50b6))
* **pointer:** set `button` and `buttons` properties on `PointerEvent` ([#1219](https://github.com/testing-library/user-event/issues/1219)) ([6614f72](https://github.com/testing-library/user-event/commit/6614f7282c75f783167fd3bee8113244a524fe20))
* **pointer:** use `1` as default value for `PointerEvent.width` and `PointerEvent.height` ([#1224](https://github.com/testing-library/user-event/issues/1224)) ([f0468d0](https://github.com/testing-library/user-event/commit/f0468d04d75c84900daf440f96b114192b920372))
* prevent `click` event loop on form-associated custom element ([#1238](https://github.com/testing-library/user-event/issues/1238)) ([465fc7e](https://github.com/testing-library/user-event/commit/465fc7eb49d38ad20b6cb227aea667167c4ea955))
* prevent `click` event on non-focusable control ([#1130](https://github.com/testing-library/user-event/issues/1130)) ([e429094](https://github.com/testing-library/user-event/commit/e4290948650a6925f549f4ec35ff74b3e81a0c64))
* **upload:** apply `accept` filter more leniently ([#1064](https://github.com/testing-library/user-event/issues/1064)) ([a344ad4](https://github.com/testing-library/user-event/commit/a344ad4dfea07b854513705d9e5ef7b3ef10919d))

### v14.6.0

- Date: 2025-01-15
- Version: v14.6.0
- Original notes: https://github.com/testing-library/user-event/releases/tag/v14.6.0
- Permalink: https://whatsnew.fyi/product/testing-library-user-event/releases/v14.6.0

- **added** — dispatch FocusEvent in hidden documents
- **fixed** — await DataTransferItem.getAsString() callback in clipboard operations
- **fixed** — assign pointer coords to MouseEvent
- **fixed** — check PointerCoords.x in isDifferentPointerPosition
- **fixed** — check all fields of PointerCoords in isDifferentPointerPosition()

##### [14.6.0](https://github.com/testing-library/user-event/compare/v14.5.2...v14.6.0) (2025-01-15)

###### Features

* dispatch `FocusEvent` in hidden documents ([#1252](https://github.com/testing-library/user-event/issues/1252)) ([1ed8b15](https://github.com/testing-library/user-event/commit/1ed8b1557b40c7ded24c62f14d33b1086ceac0a4))

###### Bug Fixes

* **clipboard:** await `DataTransferItem.getAsString()` callback ([#1251](https://github.com/testing-library/user-event/issues/1251)) ([7b11b0e](https://github.com/testing-library/user-event/commit/7b11b0e88a4bf8a3366caa70888028bf4bff59ec))
* **event:** assign pointer coords to MouseEvent ([#1039](https://github.com/testing-library/user-event/issues/1039)) ([8528972](https://github.com/testing-library/user-event/commit/852897257744b18eca56edc9dc171e626a6d9823))
* **pointer:** check `PointerCoords.x` in `isDifferentPointerPosition` ([#1216](https://github.com/testing-library/user-event/issues/1216)) ([75edef5](https://github.com/testing-library/user-event/commit/75edef5c066e30c3be28b8d607b47f7b66ad14c1))
* **pointer:** check all fields of `PointerCoords` in `isDifferentPointerPosition()` ([#1229](https://github.com/testing-library/user-event/issues/1229)) ([5f3d28f](https://github.com/testing-library/user-event/commit/5f3d28fe3a5a83b7403c1c6f41ba2be881306bfc))

### v14.5.2

- Date: 2023-12-29
- Version: v14.5.2
- Original notes: https://github.com/testing-library/user-event/releases/tag/v14.5.2
- Permalink: https://whatsnew.fyi/product/testing-library-user-event/releases/v14.5.2

- **fixed** — remove interop and deep DTL imports

##### [14.5.2](https://github.com/testing-library/user-event/compare/v14.5.1...v14.5.2) (2023-12-29)


###### Bug Fixes

* remove interop and deep DTL imports ([6a3c896](https://github.com/testing-library/user-event/commit/6a3c896bd2d77d284c6deab4f4f02c0fb366824b))

### v14.5.1

- Date: 2023-09-15
- Version: v14.5.1
- Original notes: https://github.com/testing-library/user-event/releases/tag/v14.5.1
- Permalink: https://whatsnew.fyi/product/testing-library-user-event/releases/v14.5.1

- **fixed** — incorrect default import from @testing-library/dom

##### [14.5.1](https://github.com/testing-library/user-event/compare/v14.5.0...v14.5.1) (2023-09-15)


###### Bug Fixes

* incorrect default import from @testing-library/dom ([#1162](https://github.com/testing-library/user-event/issues/1162)) ([d7483f0](https://github.com/testing-library/user-event/commit/d7483f049a1ec2ebf1ca1e2c1f4367849fca5997))

### v14.5.0

- Date: 2023-09-14
- Version: v14.5.0
- Original notes: https://github.com/testing-library/user-event/releases/tag/v14.5.0
- Permalink: https://whatsnew.fyi/product/testing-library-user-event/releases/v14.5.0

- **fixed** — Add a named export for userEvent
- **added** — Add additional type exports for UserEvent & Options

#### [14.5.0](https://github.com/testing-library/user-event/compare/v14.4.3...v14.5.0) (2023-09-14)


###### Bug Fixes

* **exports:** add a named export for userEvent ([4019cee](https://github.com/testing-library/user-event/commit/4019ceeabad2538da3f69c63bab79be731b99f3f)), closes [#1146](https://github.com/testing-library/user-event/issues/1146)


###### Features

* **types:** Add additional type exports for UserEvent & Options ([#1112](https://github.com/testing-library/user-event/issues/1112)) ([da00e8d](https://github.com/testing-library/user-event/commit/da00e8d610f10ec29d9f06ca62fa8899c53d4fd1))

### v14.4.3

- Date: 2022-08-09
- Version: v14.4.3
- Original notes: https://github.com/testing-library/user-event/releases/tag/v14.4.3
- Permalink: https://whatsnew.fyi/product/testing-library-user-event/releases/v14.4.3

- **fixed** — Add `types` field in `exports`
- **fixed** — Remove circular dependencies

##### [14.4.3](https://github.com/testing-library/user-event/compare/v14.4.2...v14.4.3) (2022-08-09)


###### Bug Fixes

* **build:** add `types` field in `exports` ([#1029](https://github.com/testing-library/user-event/issues/1029)) ([5bed8c6](https://github.com/testing-library/user-event/commit/5bed8c6a2b645e172973d55d6ac2ceb637972291))
* remove circular dependencies ([#1027](https://github.com/testing-library/user-event/issues/1027)) ([1aa2027](https://github.com/testing-library/user-event/commit/1aa2027e5ec445ab413808556efa7763b65053d3))