recipes

recipes copied to clipboard

v14.5.2

Compare Source

Bug Fixes

• remove interop and deep DTL imports (6a3c896)

v14.5.1

Compare Source

Bug Fixes

• incorrect default import from @​testing-library/dom (#​1162) (d7483f0)

v14.5.0

Compare Source

Bug Fixes

• exports: add a named export for userEvent (4019cee), closes #​1146

Features

• types: Add additional type exports for UserEvent & Options (#​1112) (da00e8d)

v14.4.3

Compare Source

Bug Fixes

• build: add types field in exports (#​1029) (5bed8c6)
• remove circular dependencies (#​1027) (1aa2027)

v14.4.2

Compare Source

Bug Fixes

• build: add exports field (#​1022) (7839e29)

v14.4.1

Compare Source

Bug Fixes

• build: transpile to es2019 syntax (#​1016) (4291cb8)

v14.4.0

Compare Source

Features

• pointer: dispatch auxclick events (#​1003) (2852509)

Bug Fixes

• event: be robust against incomplete event implementations (#​1009) (289828b)
• upload: be robust against missing FileList implementation (#​1007) (a46b4d7)
• keyboard: switch modifier state of lock keys on the correct event (#​1003) (2852509)
• keyboard: remove platform-specific additional key events for Control on AltGraph (#​1003) (2852509)
• pointer: dispatch contextmenu events with detail: 0 (#​1003) (2852509)
• pointer: always set PointerEvent.isPrimary (#​1003) (2852509)
• pointer: set button property on pointer events separately from legacy mouse events (#​1003) (2852509)
• pointer: click closest common ancestor if mousedown and mouseup happen on different elements (#​1003) (2852509)
• pointer: omit click event on release if another button is released first (#​1003) (2852509)
• pointer: dispatch mouseover, mouseenter and mousemove on disabled elements (#​1003) (2852509)
• pointer: prevent mouse* events per pointerdown event handler (#​1003) (2852509)
• pointer: dispatch *out and *over events when moving into / out of nested elements (#​1003) (2852509)
• pointer: dispatch *enter and *leave events on ancestors (#​1003) (2852509)

v14.3.0

Compare Source

Features

• keyboard: change radio group per arrow keys (#​995) (e1c22af)

v14.2.6

Compare Source

Bug Fixes

• document: reduce impact of React@17 workaround (#​992) (9816d38)
• pointer: do not throw for pointer-events: none on previous target (#​991) (6e4058b)

v14.2.5

Compare Source

Bug Fixes

• document: do not track value on HTMLSelectElement (#​989) (77a7fa8)

v14.2.4

Compare Source

Bug Fixes

• use window.FileList instead of implicit global (c88865d)

v14.2.3

Compare Source

Bug Fixes

• document: use setters/methods on element as default (#​987) (c40e614)

v14.2.2

Compare Source

Bug Fixes

• document: track HTMLInputElement.setRangeText() (#​984) (73443ec)

v14.2.1

Compare Source

Performance Improvements

• tab: avert visibility check on irrelevant elements (#​967) (d2d8a39)

v14.2.0

Compare Source

Features

• report element with declaration in pointerEventsCheck (#​950) (31b7091)

Bug Fixes

• guard against selection without range (#​953) (ab78f3f)
• selectOptions: wait after each click (#​951) (7ea7a77)
• wait after each method before leaving asyncWrapper (#​952) (6f55fee)

v14.1.1

Compare Source

14.1.1 (2022-04-17)

Bug Fixes

• remove implicit global references (#​932) (9913798)
• use globalThis instead of global (#​928) (497c14d)

v14.1.0

Compare Source

Features

• add advanceTimers option (#​907) (627a5cf)

Bug Fixes

• delete chars from value at maxlength (#​909) (f5049c4)
• reset UI selection after programmatic value change (#​915) (8bc3310)
• set initial value when setting UI value (#​918) (7b0643b)

v14.0.4

Compare Source

14.0.4 (2022-04-01)

Bug Fixes

• track calls to HTMLInputElement.select() (#​898) (6d36828)

v14.0.3

Compare Source

14.0.3 (2022-03-31)

Bug Fixes

• pointer: change selection before dispatching focus (#​895) (06f12a6)

v14.0.2

Compare Source

14.0.2 (2022-03-31)

Bug Fixes

• work around shadowed globals (#​892) (126d2e7)

v14.0.1

Compare Source

14.0.1 (2022-03-31)

Bug Fixes

• maintain UI value on controlled number input (#​889) (a7f9906)
• pointer: support nested select (#​888) (e23e559)

v14.0.0

Compare Source

⚠ BREAKING CHANGES

• APIs always return a Promise.
• pointer: skipPointerEvents has been removed. Use pointerEventsCheck: PointerEventsCheckLevel.Never instead.
• upload: init parameter has been removed from userEvent.upload.
• upload: applyAccept defaults to true.
• The userEvent.paste API has new parameters.
• {ctrl}, {del}, {esc} no longer describe a key. Use {Control}, {Delete}, {Escape} instead.
• {alt}, {ctrl}, {meta}, {shift} no longer imply not releasing the key. Use {Alt>}, {Control>}, {Meta>}, {Shift>} instead.
• init parameter has been removed from these APIs:
  • userEvent.click
  • userEvent.dblClick
  • userEvent.tripleClick
  • userEvent.hover
  • userEvent.unhover
  • userEvent.selectOptions
  • userEvent.deselectOptions
• userEvent.upload no longer supports clickInit as part of its init parameter.
• Behavior for special key descriptor {selectall} has been removed.
• Support for keyCode property on keyboard events has been removed.
• An error is thrown when calling userEvent.clear on an element which is not editable.
• An error is thrown when event handlers prevent userEvent.clear from focussing/selecting content.
• tab: The focusTrap option has been removed from userEvent.tab().
• type: userEvent.type does no longer move the cursor if used with skipClick=false and without initialSelectionStart.
• The implementation of pointer related APIs was replaced. This might break tests relying on unintended side-effects of the previous implementation.
• Support for node 10 was removed as it reached its end-of-life.

Features

• async APIs (#​790) (86860cc)
• keep track of document state in UI (#​747) (73e62d0)
• rewrite selection handling (#​776) (968c2c4)
• event: support beforeinput (#​851) (8890bd6)
• add pointer API (#​750) (c12ee44)
• add setup API (#​746) (719ba03)
• add userEvent.copy and userEvent.cut (#​787) (8727a2d)
• add userEvent.tripleClick API (#​773) (0badabd)
• apply modifier keys in pointer events (#​751) (e33eb86)
• keyboard: add [Tab] support (#​767) (87470ff)
• keyboard: apply modifier state (#​815) (e9635f6)
• keyboard: move cursor and delete content in contenteditable (#​822) (b83b259)
• keyboard: select all per {Control}+[KeyA] (#​774) (ea9b18a)
• pointer: change selection per pointer (#​763) (17fb8b1)
• pointer: introduce pointerEventsCheck option (#​823) (e2a5f43)
• remove support for user provided MouseEventInit (#​784) (56ebf7d)
• paste: replace userEvent.paste (#​785) (f8fe217)
• clear: rewrite userEvent.clear API (#​779) (1cda1b1)
• upload: replace element properties (#​794) (543eadb)

Bug Fixes

• check for inherited :disabled (#​872) (1a00fdf)
• clipboard: prevent default behavior on copy/cut (#​866) (5423094)
• clipboard: prevent default behavior on paste (#​862) (d3d71ac)
• create MouseEvents per createEvent (#​781) (da5b5b7)
• export bundled ESM (#​816) (1a5e2a7)
• export types and commonjs bundle (#​821) (4f56856)
• keyboard: parse escaped bracket followed by descriptor (#​814) (684451f)
• keyboard: parse keyboard input without nesting (#​793) (fafa677)
• keyboard: set KeyboardEvent.charCode on keypress (#​771) (55e194a)
• keyboard: submit form with <button/> on [Enter] (#​808) (eca157a)
• log correct docs link for invalid key descriptors (#​881) (28d6604)
• maintain cursor position on controlled component (#​765) (8f203cc)
• pointer: blur activeElement on click outside of focusable (#​834) (d64167c)
• pointer: consider click context (#​850) (ca4482a)
• pointer: fire pointer events on disabled elements (#​818) (ef2f4e5)
• pointer: honor click handler on <label/> (#​810) (2c5d9f1)
• pointer: trigger contextmenu on mousedown (#​811) (e1c4cad)
• prepare document in setup (#​753) (65be675)
• remove deprecated keyboard features (#​780) (45dc39a)
• remove legacy modifier implementations (#​783) (caea162)
• replace pointer implementations (#​754) (c04f79b)
• reset UI selection on setter (#​770) (2733d10)
• tab: order tabIndex>0 before tabIndex=0 (#​809) (1bc5945)
• tab: remove focusTrap option (#​772) (a0412c0)
• tab: skip elements with visibility:hidden (#​799) (a747b0a)
• upload: fix order of events (#​847) (214fd03)

Miscellaneous Chores

• drop support for node 10 (#​698) (ce01cde)

v13.5.0

Compare Source

Features

• keyboard: keep key pressed for multiple keydown events (#​728) (5d946d5)

v13.4.2

Compare Source

Bug Fixes

• keyboard: submit on enter keypress for checkboxes and radio buttons (#​741) (97ba08e)

v13.4.1

Compare Source

Bug Fixes

• keyboard: deprecate specialCharMap (#​738) (9519979)

v13.4.0

Compare Source

Features

• keyboard: handle PageUp and PageDown on input (#​734) (f731f68)

v13.3.0

Compare Source

Features

• add flag to skip pointer-events check (#​731) (26b7d0b)

v13.2.1

Compare Source

Bug Fixes

• keyboard: dispatch change event on blur (#​703) (9600abb)

v13.2.0

Compare Source

Features

• add keydownBehavior for ArrowLeft and ArrowRight on <textarea> (#​686) (f8f00d4)

v13.1.9

Compare Source

Bug Fixes

• keyboard: do not set document selection when typing on <input> (#​679) (f2fec13)

v13.1.8

Compare Source

Bug Fixes

• keyboard: maintain cursor position on controlled React input (#​665) (03f38b9)

v13.1.7

Compare Source

Bug Fixes

• upload: apply changeInit correctly (#​670) (de09b1b)

v13.1.6

Compare Source

Bug Fixes

• keyboard: add link to README in key descriptor error (#​666) (ebc90d8)

v13.1.5

Compare Source

Bug Fixes

• relax typing and throw error for unsupported elements (#​649) (dc13160)

v13.1.4

Compare Source

Bug Fixes

• keyboard: recognize checkbox/radio as clickable inputs (#​654) (35d996e)

v13.1.3

Compare Source

Bug Fixes

• throw error when click/hover on pointer-events: none (#​647) (6b2ce66)

v13.1.2

Compare Source

Bug Fixes

• replace references to global.document (#​642) (c69a74a)

v13.1.1

Compare Source

Bug Fixes

• type: catch internal promise rejections (#​635) (6ae18e3)

v13.1.0

Compare Source

Features

• support CSS pointer-events property (#​631) (32e9712)

v13.0.16

Compare Source

Bug Fixes

• keyboard: suppress invalid input on <input type="number"> (#​628) (f633a52)

v13.0.15

Compare Source

Bug Fixes

• trigger onChange in React (#​626) (3db892f)

v13.0.14

Compare Source

Bug Fixes

• dispatch input events when overwriting selection (#​623) (394d425), closes #​583

v13.0.13

Compare Source

Bug Fixes

• apply changes before input event (#​622) (5c40248), closes #​515

v13.0.12

Compare Source

Bug Fixes

• relative imports (#​621) (0882e4d)

v13.0.11

Compare Source

Bug Fixes

• handle selectionRange on different input types (#​619) (d5aa3ee)

v13.0.10

Compare Source

Bug Fixes

• omit keypress with ctrlKey or altKey (#​615) (391e513)

v13.0.9

Compare Source

Bug Fixes

• keyboard: inputType for Enter on contenteditable (#​614) (2b0632a)

v13.0.8

Compare Source

Bug Fixes

• paste: correct paste event init type (#​611) (d612aa4)

v13.0.7

Compare Source

Bug Fixes

• convert modules to typescript (#​609) (0fe1fec)

v13.0.6

Compare Source

Bug Fixes

• upload: implement iterable on input.files (#​603) (9f6355b)

v13.0.5

Compare Source

Bug Fixes

• click: right click triggers contextmenu (#​601) (16847e1)

v13.0.4

Compare Source

Bug Fixes

• convert exported modules to typescript (#​599) (be0b1b6)

v13.0.3

Compare Source

Bug Fixes

• export typings from src (#​596) (16314c6)

v13.0.2

Compare Source

Bug Fixes

• keyboard: handle invalid or empty maxlength (#​595) (2180430)

v13.0.1

Compare Source

Bug Fixes

• keyboard: parse modifiers as characters (#​588) (fa9299e)

v13.0.0

Compare Source

Features

• add userEvent.keyboard API (#​581) (f251d15)

BREAKING CHANGES

• userEvent.type features a rewritten implementation shared with the new userEvent.keyboard. This might break code depending on unintended/undocumented behavior of the previous implementation.
• userEvent.type treats { and [ as special characters.
• userEvent.type returns no Promise if called without delay.