feat: Test utils API audit, additional feature coverage (RTL, grid nav, etc) in prep for RC/1.0 by LFDanLu · Pull Request #9998 · adobe/react-spectrum

LFDanLu · 2026-04-29T22:35:30Z

See commits for what changed

Some additional pattern support to be opened in a different PR maybe, to discuss if we think they are worth it or not.

✅ Pull Request Checklist:

Included link to corresponding React Spectrum GitHub Issue.
Added/updated unit tests and storybook for this change (for new code or code which already has tests).
Filled out test instructions.
Updated documentation (if it already exists for this component).
Looked at the Accessibility Practices for this feature - Aria Practices

📝 Test Instructions:

🧢 Your Project:

RSP

…d select all

also gives us the option of adding args in the future

this is a lower level than using react testing library of which we wernt really using anything unique from that library. trade off is that we need to wrap act so it works for other react versions, still not 100% sure if we wanna do this

…essages more descriptive

rspbot · 2026-04-30T18:11:10Z

Build successful! 🎉

rspbot · 2026-04-30T20:59:42Z

Build successful! 🎉

… convert tests

rspbot · 2026-05-01T20:38:39Z

Build successful! 🎉

…s-1.0

rspbot · 2026-05-01T22:41:39Z

Build successful! 🎉

snowystinger · 2026-05-08T01:48:18Z

    }

-    if (!this.checkboxgroup.contains(document.activeElement)) {
+    if (!this.checkboxgroup().contains(document.activeElement)) {


if it's a function, then I think I'd prefer the naming scheme getCheckboxGroup

snowystinger · 2026-05-08T02:02:29Z

@@ -59,33 +60,50 @@ export async function triggerLongPress(opts: {element: HTMLElement, advanceTimer
  // util before first render. Will need to document it well
  let {element, advanceTimer, pointerOpts = {}} = opts;
  let pointerType = pointerOpts.pointerType ?? 'mouse';
-  let shouldFireCompatibilityEvents = fireEvent.pointerDown(element, {pointerType, ...pointerOpts});


instead of this, we should do what react testing library does and configure the dom testing library to wrap events https://github.com/testing-library/react-testing-library/blob/be9d81d91314c9f0bafaa363f70b409b4b31989c/src/pure.js#L60

However, there's a bigger issue I'm worried about, react testing library actually modifies fireEvent pretty substantially with React specific things, so we'd need to probably copy this as well
https://github.com/testing-library/react-testing-library/blob/main/src/fire-event.js

I imagine we need the other things in that configuration as well

just realised this is in our testing tools, not a test
I'm not sure we need to include the act wrapper, the users environment should handle it

how did you determine you needed these?

the long press tests started failing without these after I switched to testing-library/dom, I believe react testing library does some auto wrapping

i think the right thing is going to be for people to pass in their fireEvent implementation themselves, that way we don't need to worry about if it should be wrapped in an act or not.

snowystinger · 2026-05-08T03:24:20Z


+export function formatTargetNode(value: number | string | HTMLElement): string {
+  if (typeof HTMLElement !== 'undefined' && value instanceof HTMLElement) {
+    return value.outerHTML;


could be very large, how would you feel about something like

value.cloneNode(false).outerHTML

this will remove all the children and just give you the tag + attributes

snowystinger · 2026-05-08T03:25:28Z

-        }
+    let menu = this.menu();
+    if (!menu) {
+      throw new Error('Cannot open submenu, parent menu didn\'t open on trigger "${formatTargetNode(trigger)}" press.');


missing the interpolation backticks

good catch thanks!

snowystinger · 2026-05-08T03:29:31Z

    expect(within(row).getByRole('checkbox')).toBeDisabled();
+
+    let gridListTester = testUtilUser.createTester('GridList', {root: getByRole('grid')});
+    await expect(gridListTester.toggleRowSelection({row: 0})).rejects.toThrow();


something to remember, expect.toThrow is extremely slow

snowystinger · 2026-05-08T03:34:02Z

 }

-export const act = actImpl;
+export const act: typeof actImpl = ((fn: any) => {


missing async?

I don't think so since we are just either passing the provided fn to the act wrapper from react or returning the fn call as is, shouldn't matter if the fn provided is async or not since they can await it if need be

hmmm why do you need the as then? or the any? that should be fn: () => void | Promise no?

snowystinger · 2026-05-08T03:34:53Z

+        let curr = (document.activeElement as HTMLElement).getBoundingClientRect();
+        let target = option.getBoundingClientRect();
+        let key: string;
+        // basically compare current position with desired position to determine if we need to go up/down/left/right


~~basically~~ compare current position with desired position to determine if we need to go up/down/left/right

snowystinger · 2026-05-08T03:58:17Z

this should accept a rowGroup to look within i think since we now support tables with multiple bodies/row groups

oh good point, I forgot that existed since it wasn't in the docs haha. I'll update

snowystinger · 2026-05-08T03:58:43Z

+   * Returns the footer rows within the table if any.
+   */
+  footerRows(): HTMLElement[] {
+    let footerRowGroup = this.rowGroups()[2];


this may not be true

…s-1.0

…Node, fix missing menu tests from bad merge

rspbot · 2026-05-09T00:21:44Z

Build successful! 🎉

rspbot · 2026-05-09T00:21:45Z

## API Changes

@react-aria/test-utils

/@react-aria/test-utils:CheckboxGroupTester

 CheckboxGroupTester {
-  checkboxes: Array<HTMLElement>
-  checkboxgroup: HTMLElement
   constructor: (CheckboxGroupTesterOpts) => void
   findCheckbox: ({
-    checkboxIndexOrText: number | string
+    indexOrText: number | string
 }) => HTMLElement
-  selectedCheckboxes: Array<HTMLElement>
+  getCheckboxGroup: () => HTMLElement
+  getCheckboxes: () => Array<HTMLElement>
+  getSelectedCheckboxes: () => Array<HTMLElement>
   setInteractionType: (UserOpts['interactionType']) => void
   toggleCheckbox: (TriggerCheckboxOptions) => Promise<void>
 }

/@react-aria/test-utils:ComboBoxTester

 ComboBoxTester {
   close: () => Promise<void>
-  combobox: HTMLElement
   constructor: (ComboBoxTesterOpts) => void
   findOption: ({
-    optionIndexOrText: number | string
+    indexOrText: number | string
 }) => HTMLElement
-  focusedOption: HTMLElement | null
-  listbox: HTMLElement | null
-  open: (ComboBoxOpenOpts) => Promise<void>
-  options: ({
+  getCombobox: () => HTMLElement
+  getFocusedOption: () => HTMLElement | null
+  getListbox: () => HTMLElement | null
+  getOptions: ({
     element?: HTMLElement
 }) => Array<HTMLElement>
-  sections: Array<HTMLElement>
-  selectOption: (ComboBoxSelectOpts) => Promise<void>
+  getSections: () => Array<HTMLElement>
+  getTrigger: () => HTMLElement
+  open: (ComboBoxOpenOpts) => Promise<void>
   setInteractionType: (UserOpts['interactionType']) => void
-  trigger: HTMLElement
+  toggleOptionSelection: (ComboBoxSelectOpts) => Promise<void>
 }

/@react-aria/test-utils:DialogTester

 DialogTester {
   close: () => Promise<void>
   constructor: (DialogTesterOpts) => void
-  dialog: HTMLElement | null
+  getDialog: () => HTMLElement | null
+  getTrigger: () => HTMLElement
   open: (DialogOpenOpts) => Promise<void>
   setInteractionType: (UserOpts['interactionType']) => void
-  trigger: HTMLElement
 }

/@react-aria/test-utils:GridListTester

 GridListTester {
-  cells: ({
-    element?: HTMLElement
-}) => Array<HTMLElement>
   constructor: (GridListTesterOpts) => void
   findRow: ({
-    rowIndexOrText: number | string
+    indexOrText: number | string
 }) => HTMLElement
-  gridlist: HTMLElement
-  rows: Array<HTMLElement>
-  selectedRows: Array<HTMLElement>
+  getCells: ({
+    element?: HTMLElement
+}) => Array<HTMLElement>
+  getGridlist: () => HTMLElement
+  getRows: () => Array<HTMLElement>
+  getSelectedRows: () => Array<HTMLElement>
   setInteractionType: (UserOpts['interactionType']) => void
   toggleRowSelection: (GridListToggleRowOpts) => Promise<void>
   triggerRowAction: (GridListRowActionOpts) => Promise<void>
 }

/@react-aria/test-utils:ListBoxTester

 ListBoxTester {
   constructor: (ListBoxTesterOpts) => void
   findOption: ({
-    optionIndexOrText: number | string
+    indexOrText: number | string
 }) => HTMLElement
-  listbox: HTMLElement
-  options: ({
+  getListbox: () => HTMLElement
+  getOptions: ({
     element?: HTMLElement
 }) => Array<HTMLElement>
-  sections: Array<HTMLElement>
-  selectedOptions: Array<HTMLElement>
+  getSections: () => Array<HTMLElement>
+  getSelectedOptions: () => Array<HTMLElement>
   setInteractionType: (UserOpts['interactionType']) => void
   toggleOptionSelection: (ListBoxToggleOptionOpts) => Promise<void>
   triggerOptionAction: (ListBoxOptionActionOpts) => Promise<void>
 }

/@react-aria/test-utils:MenuTester

 MenuTester {
   close: () => Promise<void>
   constructor: (MenuTesterOpts) => void
   findOption: ({
-    optionIndexOrText: number | string
+    indexOrText: number | string
 }) => HTMLElement
-  menu: HTMLElement | null
-  open: (MenuOpenOpts) => Promise<void>
-  openSubmenu: (MenuOpenSubmenuOpts) => Promise<MenuTester | null>
-  options: ({
+  getMenu: () => HTMLElement | null
+  getOptions: ({
     element?: HTMLElement
 }) => Array<HTMLElement>
-  sections: Array<HTMLElement>
-  selectOption: (MenuSelectOpts) => Promise<void>
+  getSections: () => Array<HTMLElement>
+  getSubmenuTriggers: () => Array<HTMLElement>
+  getTrigger: () => HTMLElement
+  open: (MenuOpenOpts) => Promise<void>
+  openSubmenu: (MenuOpenSubmenuOpts) => Promise<MenuTester>
   setInteractionType: (UserOpts['interactionType']) => void
-  submenuTriggers: Array<HTMLElement>
-  trigger: HTMLElement
+  toggleOptionSelection: (MenuSelectOpts) => Promise<void>
 }

/@react-aria/test-utils:RadioGroupTester

 RadioGroupTester {
   constructor: (RadioGroupTesterOpts) => void
   findRadio: ({
-    radioIndexOrText: number | string
+    indexOrText: number | string
 }) => HTMLElement
-  radiogroup: HTMLElement
-  radios: Array<HTMLElement>
-  selectedRadio: HTMLElement | null
+  getRadioGroup: () => HTMLElement
+  getRadios: () => Array<HTMLElement>
+  getSelectedRadio: () => HTMLElement | null
   setInteractionType: (UserOpts['interactionType']) => void
   triggerRadio: (TriggerRadioOptions) => Promise<void>
 }

/@react-aria/test-utils:SelectTester

 SelectTester {
   close: () => Promise<void>
   constructor: (SelectTesterOpts) => void
   findOption: ({
-    optionIndexOrText: number | string
+    indexOrText: number | string
 }) => HTMLElement
-  listbox: HTMLElement | null
-  open: (SelectOpenOpts) => Promise<void>
-  options: ({
+  getListbox: () => HTMLElement | null
+  getOptions: ({
     element?: HTMLElement
 }) => Array<HTMLElement>
-  sections: Array<HTMLElement>
-  selectOption: (SelectTriggerOptionOpts) => Promise<void>
+  getSections: () => Array<HTMLElement>
+  getTrigger: () => HTMLElement
+  open: (SelectOpenOpts) => Promise<void>
   setInteractionType: (UserOpts['interactionType']) => void
-  trigger: HTMLElement
+  toggleOptionSelection: (SelectTriggerOptionOpts) => Promise<void>
 }

/@react-aria/test-utils:TableTester

 TableTester {
-  cells: ({
-    element?: HTMLElement
-}) => Array<HTMLElement>
-  columns: Array<HTMLElement>
   constructor: (TableTesterOpts) => void
   findCell: ({
     text: string
 }) => HTMLElement
   findRow: ({
-    rowIndexOrText: number | string
+    indexOrText: number | string
 }) => HTMLElement
-  rowGroups: Array<HTMLElement>
-  rowHeaders: Array<HTMLElement>
-  rows: Array<HTMLElement>
-  selectedRows: Array<HTMLElement>
+  getCells: ({
+    element?: HTMLElement
+}) => Array<HTMLElement>
+  getColumns: () => Array<HTMLElement>
+  getFooterRows: () => Array<HTMLElement>
+  getRowGroups: () => Array<HTMLElement>
+  getRowHeaders: () => Array<HTMLElement>
+  getRows: ({
+    element?: HTMLElement
+}) => Array<HTMLElement>
+  getSelectedRows: () => Array<HTMLElement>
+  getTable: () => HTMLElement
   setInteractionType: (UserOpts['interactionType']) => void
-  table: HTMLElement
   toggleRowExpansion: (TableToggleExpansionOpts) => Promise<void>
   toggleRowSelection: (TableToggleRowOpts) => Promise<void>
   toggleSelectAll: ({
     interactionType?: UserOpts['interactionType']
   toggleSort: (TableToggleSortOpts) => Promise<void>
   triggerColumnHeaderAction: (TableColumnHeaderActionOpts) => Promise<void>
   triggerRowAction: (TableRowActionOpts) => Promise<void>
 }

/@react-aria/test-utils:TabsTester

 TabsTester {
-  activeTabpanel: HTMLElement | null
   constructor: (TabsTesterOpts) => void
   findTab: ({
-    tabIndexOrText: number | string
+    indexOrText: number | string
 }) => HTMLElement
-  selectedTab: HTMLElement | null
+  getActiveTabpanel: () => HTMLElement | null
+  getSelectedTab: () => HTMLElement | null
+  getTablist: () => HTMLElement
+  getTabpanels: () => Array<HTMLElement>
+  getTabs: () => Array<HTMLElement>
   setInteractionType: (UserOpts['interactionType']) => void
-  tablist: HTMLElement
-  tabpanels: Array<HTMLElement>
-  tabs: Array<HTMLElement>
   triggerTab: (TriggerTabOptions) => Promise<void>
 }

/@react-aria/test-utils:TreeTester

 TreeTester {
-  cells: ({
-    element?: HTMLElement
-}) => Array<HTMLElement>
   constructor: (TreeTesterOpts) => void
   findRow: ({
-    rowIndexOrText: number | string
+    indexOrText: number | string
 }) => HTMLElement
-  rows: Array<HTMLElement>
-  selectedRows: Array<HTMLElement>
+  getCells: ({
+    element?: HTMLElement
+}) => Array<HTMLElement>
+  getRows: () => Array<HTMLElement>
+  getSelectedRows: () => Array<HTMLElement>
+  getTree: () => HTMLElement
   setInteractionType: (UserOpts['interactionType']) => void
   toggleRowExpansion: (TreeToggleExpansionOpts) => Promise<void>
   toggleRowSelection: (TreeToggleRowOpts) => Promise<void>
-  tree: HTMLElement
   triggerRowAction: (TreeRowActionOpts) => Promise<void>
 }

@react-spectrum/test-utils

/@react-spectrum/test-utils:CheckboxGroupTester

 CheckboxGroupTester {
-  checkboxes: Array<HTMLElement>
-  checkboxgroup: HTMLElement
   constructor: (CheckboxGroupTesterOpts) => void
   findCheckbox: ({
-    checkboxIndexOrText: number | string
+    indexOrText: number | string
 }) => HTMLElement
-  selectedCheckboxes: Array<HTMLElement>
+  getCheckboxGroup: () => HTMLElement
+  getCheckboxes: () => Array<HTMLElement>
+  getSelectedCheckboxes: () => Array<HTMLElement>
   setInteractionType: (UserOpts['interactionType']) => void
   toggleCheckbox: (TriggerCheckboxOptions) => Promise<void>
 }

/@react-spectrum/test-utils:ComboBoxTester

 ComboBoxTester {
   close: () => Promise<void>
-  combobox: HTMLElement
   constructor: (ComboBoxTesterOpts) => void
   findOption: ({
-    optionIndexOrText: number | string
+    indexOrText: number | string
 }) => HTMLElement
-  focusedOption: HTMLElement | null
-  listbox: HTMLElement | null
-  open: (ComboBoxOpenOpts) => Promise<void>
-  options: ({
+  getCombobox: () => HTMLElement
+  getFocusedOption: () => HTMLElement | null
+  getListbox: () => HTMLElement | null
+  getOptions: ({
     element?: HTMLElement
 }) => Array<HTMLElement>
-  sections: Array<HTMLElement>
-  selectOption: (ComboBoxSelectOpts) => Promise<void>
+  getSections: () => Array<HTMLElement>
+  getTrigger: () => HTMLElement
+  open: (ComboBoxOpenOpts) => Promise<void>
   setInteractionType: (UserOpts['interactionType']) => void
-  trigger: HTMLElement
+  toggleOptionSelection: (ComboBoxSelectOpts) => Promise<void>
 }

/@react-spectrum/test-utils:DialogTester

 DialogTester {
   close: () => Promise<void>
   constructor: (DialogTesterOpts) => void
-  dialog: HTMLElement | null
+  getDialog: () => HTMLElement | null
+  getTrigger: () => HTMLElement
   open: (DialogOpenOpts) => Promise<void>
   setInteractionType: (UserOpts['interactionType']) => void
-  trigger: HTMLElement
 }

/@react-spectrum/test-utils:GridListTester

 GridListTester {
-  cells: ({
-    element?: HTMLElement
-}) => Array<HTMLElement>
   constructor: (GridListTesterOpts) => void
   findRow: ({
-    rowIndexOrText: number | string
+    indexOrText: number | string
 }) => HTMLElement
-  gridlist: HTMLElement
-  rows: Array<HTMLElement>
-  selectedRows: Array<HTMLElement>
+  getCells: ({
+    element?: HTMLElement
+}) => Array<HTMLElement>
+  getGridlist: () => HTMLElement
+  getRows: () => Array<HTMLElement>
+  getSelectedRows: () => Array<HTMLElement>
   setInteractionType: (UserOpts['interactionType']) => void
   toggleRowSelection: (GridListToggleRowOpts) => Promise<void>
   triggerRowAction: (GridListRowActionOpts) => Promise<void>
 }

/@react-spectrum/test-utils:ListBoxTester

 ListBoxTester {
   constructor: (ListBoxTesterOpts) => void
   findOption: ({
-    optionIndexOrText: number | string
+    indexOrText: number | string
 }) => HTMLElement
-  listbox: HTMLElement
-  options: ({
+  getListbox: () => HTMLElement
+  getOptions: ({
     element?: HTMLElement
 }) => Array<HTMLElement>
-  sections: Array<HTMLElement>
-  selectedOptions: Array<HTMLElement>
+  getSections: () => Array<HTMLElement>
+  getSelectedOptions: () => Array<HTMLElement>
   setInteractionType: (UserOpts['interactionType']) => void
   toggleOptionSelection: (ListBoxToggleOptionOpts) => Promise<void>
   triggerOptionAction: (ListBoxOptionActionOpts) => Promise<void>
 }

/@react-spectrum/test-utils:MenuTester

 MenuTester {
   close: () => Promise<void>
   constructor: (MenuTesterOpts) => void
   findOption: ({
-    optionIndexOrText: number | string
+    indexOrText: number | string
 }) => HTMLElement
-  menu: HTMLElement | null
-  open: (MenuOpenOpts) => Promise<void>
-  openSubmenu: (MenuOpenSubmenuOpts) => Promise<MenuTester | null>
-  options: ({
+  getMenu: () => HTMLElement | null
+  getOptions: ({
     element?: HTMLElement
 }) => Array<HTMLElement>
-  sections: Array<HTMLElement>
-  selectOption: (MenuSelectOpts) => Promise<void>
+  getSections: () => Array<HTMLElement>
+  getSubmenuTriggers: () => Array<HTMLElement>
+  getTrigger: () => HTMLElement
+  open: (MenuOpenOpts) => Promise<void>
+  openSubmenu: (MenuOpenSubmenuOpts) => Promise<MenuTester>
   setInteractionType: (UserOpts['interactionType']) => void
-  submenuTriggers: Array<HTMLElement>
-  trigger: HTMLElement
+  toggleOptionSelection: (MenuSelectOpts) => Promise<void>
 }

/@react-spectrum/test-utils:RadioGroupTester

 RadioGroupTester {
   constructor: (RadioGroupTesterOpts) => void
   findRadio: ({
-    radioIndexOrText: number | string
+    indexOrText: number | string
 }) => HTMLElement
-  radiogroup: HTMLElement
-  radios: Array<HTMLElement>
-  selectedRadio: HTMLElement | null
+  getRadioGroup: () => HTMLElement
+  getRadios: () => Array<HTMLElement>
+  getSelectedRadio: () => HTMLElement | null
   setInteractionType: (UserOpts['interactionType']) => void
   triggerRadio: (TriggerRadioOptions) => Promise<void>
 }

/@react-spectrum/test-utils:SelectTester

 SelectTester {
   close: () => Promise<void>
   constructor: (SelectTesterOpts) => void
   findOption: ({
-    optionIndexOrText: number | string
+    indexOrText: number | string
 }) => HTMLElement
-  listbox: HTMLElement | null
-  open: (SelectOpenOpts) => Promise<void>
-  options: ({
+  getListbox: () => HTMLElement | null
+  getOptions: ({
     element?: HTMLElement
 }) => Array<HTMLElement>
-  sections: Array<HTMLElement>
-  selectOption: (SelectTriggerOptionOpts) => Promise<void>
+  getSections: () => Array<HTMLElement>
+  getTrigger: () => HTMLElement
+  open: (SelectOpenOpts) => Promise<void>
   setInteractionType: (UserOpts['interactionType']) => void
-  trigger: HTMLElement
+  toggleOptionSelection: (SelectTriggerOptionOpts) => Promise<void>
 }

/@react-spectrum/test-utils:TableTester

 TableTester {
-  cells: ({
-    element?: HTMLElement
-}) => Array<HTMLElement>
-  columns: Array<HTMLElement>
   constructor: (TableTesterOpts) => void
   findCell: ({
     text: string
 }) => HTMLElement
   findRow: ({
-    rowIndexOrText: number | string
+    indexOrText: number | string
 }) => HTMLElement
-  rowGroups: Array<HTMLElement>
-  rowHeaders: Array<HTMLElement>
-  rows: Array<HTMLElement>
-  selectedRows: Array<HTMLElement>
+  getCells: ({
+    element?: HTMLElement
+}) => Array<HTMLElement>
+  getColumns: () => Array<HTMLElement>
+  getFooterRows: () => Array<HTMLElement>
+  getRowGroups: () => Array<HTMLElement>
+  getRowHeaders: () => Array<HTMLElement>
+  getRows: ({
+    element?: HTMLElement
+}) => Array<HTMLElement>
+  getSelectedRows: () => Array<HTMLElement>
+  getTable: () => HTMLElement
   setInteractionType: (UserOpts['interactionType']) => void
-  table: HTMLElement
   toggleRowExpansion: (TableToggleExpansionOpts) => Promise<void>
   toggleRowSelection: (TableToggleRowOpts) => Promise<void>
   toggleSelectAll: ({
     interactionType?: UserOpts['interactionType']
   toggleSort: (TableToggleSortOpts) => Promise<void>
   triggerColumnHeaderAction: (TableColumnHeaderActionOpts) => Promise<void>
   triggerRowAction: (TableRowActionOpts) => Promise<void>
 }

/@react-spectrum/test-utils:TabsTester

 TabsTester {
-  activeTabpanel: HTMLElement | null
   constructor: (TabsTesterOpts) => void
   findTab: ({
-    tabIndexOrText: number | string
+    indexOrText: number | string
 }) => HTMLElement
-  selectedTab: HTMLElement | null
+  getActiveTabpanel: () => HTMLElement | null
+  getSelectedTab: () => HTMLElement | null
+  getTablist: () => HTMLElement
+  getTabpanels: () => Array<HTMLElement>
+  getTabs: () => Array<HTMLElement>
   setInteractionType: (UserOpts['interactionType']) => void
-  tablist: HTMLElement
-  tabpanels: Array<HTMLElement>
-  tabs: Array<HTMLElement>
   triggerTab: (TriggerTabOptions) => Promise<void>
 }

/@react-spectrum/test-utils:TreeTester

 TreeTester {
-  cells: ({
-    element?: HTMLElement
-}) => Array<HTMLElement>
   constructor: (TreeTesterOpts) => void
   findRow: ({
-    rowIndexOrText: number | string
+    indexOrText: number | string
 }) => HTMLElement
-  rows: Array<HTMLElement>
-  selectedRows: Array<HTMLElement>
+  getCells: ({
+    element?: HTMLElement
+}) => Array<HTMLElement>
+  getRows: () => Array<HTMLElement>
+  getSelectedRows: () => Array<HTMLElement>
+  getTree: () => HTMLElement
   setInteractionType: (UserOpts['interactionType']) => void
   toggleRowExpansion: (TreeToggleExpansionOpts) => Promise<void>
   toggleRowSelection: (TreeToggleRowOpts) => Promise<void>
-  tree: HTMLElement
   triggerRowAction: (TreeRowActionOpts) => Promise<void>
 }

LFDanLu added 17 commits April 27, 2026 15:07

add proper keyboard navigation to combobox

af2817e

mutiple select for combobox, api rename for consitency, table keyboar…

4e1c651

…d select all

add tests for deselect

d828424

get rid of timer warnings cuz user gives a default if not provided

9cc80d8

change getters into method calls for consistency

2556c18

also gives us the option of adding args in the future

update instances of old getters to new function calls

0f0bd7d

update instances of old getters to new function calls

c694bb4

switch to dom testing library

c9125d3

this is a lower level than using react testing library of which we wernt really using anything unique from that library. trade off is that we need to wrap act so it works for other react versions, still not 100% sure if we wanna do this

support missing RTL for expand and keyboard nav

1beb706

standardize indexOrText option naming

59994d3

throw when attempting to interact with disabled rows and make error m…

c86baaf

…essages more descriptive

update readmes and docs to reflect change to testing-library/dom

53187c3

more audit items

8a871db

add tests to cover error messages

a20ca65

cleanup todos that we are punting on/not doing

348c5f7

add grid navigation to listbox test util and fix browser tests

3c4d45e

add grid nav to gridlist too

b1ca6f4

github-actions Bot added RAC S2 labels Apr 29, 2026

add browser tests for each pattern to make sure utils work with it

226f5d9

LFDanLu added 3 commits April 30, 2026 11:55

adding midding dialog testing pages to RAC

3e45ed4

add rough skills for the test utils

1687d0d

forgot to save

3e6d64a

LFDanLu marked this pull request as ready for review April 30, 2026 22:47

LFDanLu added the ready for review label Apr 30, 2026

LFDanLu added 3 commits April 30, 2026 16:36

improvements to skill guidence and utils from attempt to use skill to…

1dc99d1

… convert tests

more improvements from second pass

3fac945

add getter for table footer

bc32b85

Merge branch 'main' of github.com:adobe/react-spectrum into test-util…

cf0038a

…s-1.0

LFDanLu force-pushed the test-utils-1.0 branch from 9747b05 to cf0038a Compare May 1, 2026 22:33

LFDanLu added the no testing Does not require manual testing during testing session label May 5, 2026

snowystinger reviewed May 8, 2026

View reviewed changes

Comment thread packages/@react-aria/test-utils/src/menu.ts

snowystinger reviewed May 8, 2026

View reviewed changes

LFDanLu added 8 commits May 8, 2026 15:10

Merge branch 'main' of github.com:adobe/react-spectrum into test-util…

b513616

…s-1.0

formatting

ed0919b

update getter naming

ed6c99c

update table util for rowgroups and table footer, update formatTarget…

10870bf

…Node, fix missing menu tests from bad merge

formatting

c109290

fix test from bad merge

6d01a4c

add missing aria labels to browser tests

41fb378

how did this not auto format

38ec8e2

Conversation

LFDanLu commented Apr 29, 2026

✅ Pull Request Checklist:

📝 Test Instructions:

🧢 Your Project:

Uh oh!

rspbot commented Apr 30, 2026

Uh oh!

rspbot commented Apr 30, 2026

Uh oh!

rspbot commented May 1, 2026

Uh oh!

rspbot commented May 1, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

rspbot commented May 9, 2026

Uh oh!

rspbot commented May 9, 2026

@react-aria/test-utils

/@react-aria/test-utils:CheckboxGroupTester

/@react-aria/test-utils:ComboBoxTester

/@react-aria/test-utils:DialogTester

/@react-aria/test-utils:GridListTester

/@react-aria/test-utils:ListBoxTester

/@react-aria/test-utils:MenuTester

/@react-aria/test-utils:RadioGroupTester

/@react-aria/test-utils:SelectTester

/@react-aria/test-utils:TableTester

/@react-aria/test-utils:TabsTester

/@react-aria/test-utils:TreeTester

@react-spectrum/test-utils

/@react-spectrum/test-utils:CheckboxGroupTester

/@react-spectrum/test-utils:ComboBoxTester

/@react-spectrum/test-utils:DialogTester

/@react-spectrum/test-utils:GridListTester

/@react-spectrum/test-utils:ListBoxTester

/@react-spectrum/test-utils:MenuTester

/@react-spectrum/test-utils:RadioGroupTester

/@react-spectrum/test-utils:SelectTester

/@react-spectrum/test-utils:TableTester

/@react-spectrum/test-utils:TabsTester

/@react-spectrum/test-utils:TreeTester

Uh oh!

Reviewers

Assignees

Labels