@react-aria/test-utils 1.0.0-beta.1 → 1.0.0-beta.3

package/src/radiogroup.ts

@@ -0,0 +1,176 @@
+/*
+ * Copyright 2025 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import {act, within} from '@testing-library/react';
+import {Direction, Orientation, RadioGroupTesterOpts, UserOpts} from './types';
+import {pressElement} from './events';
+
+interface TriggerRadioOptions {
+  /**
+   * What interaction type to use when triggering a radio. Defaults to the interaction type set on the tester.
+   */
+  interactionType?: UserOpts['interactionType'],
+  /**
+   * The index, text, or node of the radio to toggle selection for.
+   */
+  radio: number | string | HTMLElement
+}
+
+export class RadioGroupTester {
+  private user;
+  private _interactionType: UserOpts['interactionType'];
+  private _radiogroup: HTMLElement;
+  private _direction: Direction;
+
+  constructor(opts: RadioGroupTesterOpts) {
+    let {root, user, interactionType, direction} = opts;
+    this.user = user;
+    this._interactionType = interactionType || 'mouse';
+    this._direction = direction || 'ltr';
+
+    this._radiogroup = root;
+    let radiogroup = within(root).queryAllByRole('radiogroup');
+    if (radiogroup.length > 0) {
+      this._radiogroup = radiogroup[0];
+    }
+  }
+
+  /**
+   * Set the interaction type used by the radio tester.
+   */
+  setInteractionType(type: UserOpts['interactionType']): void {
+    this._interactionType = type;
+  }
+
+  /**
+   * Returns a radio matching the specified index or text content.
+   */
+  findRadio(opts: {radioIndexOrText: number | string}): HTMLElement {
+    let {
+      radioIndexOrText
+    } = opts;
+
+    let radio;
+    if (typeof radioIndexOrText === 'number') {
+      radio = this.radios[radioIndexOrText];
+    } else if (typeof radioIndexOrText === 'string') {
+      let label = within(this.radiogroup).getByText(radioIndexOrText);
+      // Label may wrap the radio, or the actual label may be a sibling span, or the radio div could have the label within it
+      if (label) {
+        radio = within(label).queryByRole('radio');
+        if (!radio) {
+          let labelWrapper = label.closest('label');
+          if (labelWrapper) {
+            radio = within(labelWrapper).queryByRole('radio');
+          } else {
+            radio = label.closest('[role=radio]');
+          }
+        }
+      }
+    }
+
+    return radio;
+  }
+
+  private async keyboardNavigateToRadio(opts: {radio: HTMLElement, orientation?: Orientation}) {
+    let {radio, orientation = 'vertical'} = opts;
+    let radios = this.radios;
+    radios = radios.filter(radio => !(radio.hasAttribute('disabled') || radio.getAttribute('aria-disabled') === 'true'));
+    if (radios.length === 0) {
+      throw new Error('Radio group doesnt have any non-disabled radios. Please double check your radio group.');
+    }
+
+    let targetIndex = radios.indexOf(radio);
+    if (targetIndex === -1) {
+      throw new Error('Radio provided is not in the radio group.');
+    }
+
+    if (!this.radiogroup.contains(document.activeElement)) {
+      let selectedRadio = this.selectedRadio;
+      if (selectedRadio != null) {
+        act(() => selectedRadio.focus());
+      } else {
+        act(() => radios[0]?.focus());
+      }
+    }
+
+    let currIndex = radios.indexOf(document.activeElement as HTMLElement);
+    if (currIndex === -1) {
+      throw new Error('Active element is not in the radio group.');
+    }
+
+    let arrowUp = 'ArrowUp';
+    let arrowDown = 'ArrowDown';
+    if (orientation === 'horizontal') {
+      if (this._direction === 'ltr') {
+        arrowUp = 'ArrowLeft';
+        arrowDown = 'ArrowRight';
+      } else {
+        arrowUp = 'ArrowRight';
+        arrowDown = 'ArrowLeft';
+      }
+    }
+
+    let movementDirection = targetIndex > currIndex ? 'down' : 'up';
+    for (let i = 0; i < Math.abs(targetIndex - currIndex); i++) {
+      await this.user.keyboard(`[${movementDirection === 'down' ? arrowDown : arrowUp}]`);
+    }
+  };
+
+  /**
+   * Triggers the specified radio. Defaults to using the interaction type set on the radio tester.
+   */
+  async triggerRadio(opts: TriggerRadioOptions): Promise<void> {
+    let {
+      radio,
+      interactionType = this._interactionType
+    } = opts;
+
+    if (typeof radio === 'string' || typeof radio === 'number') {
+      radio = this.findRadio({radioIndexOrText: radio});
+    }
+
+    if (!radio) {
+      throw new Error('Target radio not found in the radio group.');
+    } else if (radio.hasAttribute('disabled')) {
+      throw new Error('Target radio is disabled.');
+    }
+
+    if (interactionType === 'keyboard') {
+      let radioOrientation = this._radiogroup.getAttribute('aria-orientation') || 'horizontal';
+      await this.keyboardNavigateToRadio({radio, orientation: radioOrientation as Orientation});
+    } else {
+      await pressElement(this.user, radio, interactionType);
+    }
+  }
+
+  /**
+   * Returns the radiogroup.
+   */
+  get radiogroup(): HTMLElement {
+    return this._radiogroup;
+  }
+
+  /**
+   * Returns the radios.
+   */
+  get radios(): HTMLElement[] {
+    return within(this.radiogroup).queryAllByRole('radio');
+  }
+
+  /**
+   * Returns the currently selected radio in the radiogroup if any.
+   */
+  get selectedRadio(): HTMLElement | null {
+    return this.radios.find(radio => (radio as HTMLInputElement).checked) || null;
+  }
+}

package/src/select.ts

@@ -24,7 +24,12 @@ interface SelectTriggerOptionOpts extends SelectOpenOpts {
   /**
    * The index, text, or node of the option to select. Option nodes can be sourced via `options()`.
    */
-  option: number | string | HTMLElement
+  option: number | string | HTMLElement,
+  /**
+   * Whether or not the select closes on selection. Depends on select implementation and configuration.
+   * @default true
+   */
+  closesOnSelect?: boolean
 }
 
 export class SelectTester {
@@ -164,6 +169,7 @@ export class SelectTester {
   async selectOption(opts: SelectTriggerOptionOpts): Promise<void> {
     let {
       option,
+      closesOnSelect,
       interactionType = this._interactionType
     } = opts || {};
     let trigger = this.trigger;
@@ -185,6 +191,8 @@ export class SelectTester {
       }
 
       let isMultiSelect = listbox.getAttribute('aria-multiselectable') === 'true';
+      let isSingleSelect = !isMultiSelect;
+      closesOnSelect = closesOnSelect ?? isSingleSelect;
 
       if (interactionType === 'keyboard') {
         if (option?.getAttribute('aria-disabled') === 'true') {
@@ -205,7 +213,7 @@ export class SelectTester {
         }
       }
 
-      if (!isMultiSelect && option?.getAttribute('href') == null) {
+      if (closesOnSelect && option?.getAttribute('href') == null) {
         await waitFor(() => {
           if (document.activeElement !== this._trigger) {
             throw new Error(`Expected the document.activeElement after selecting an option to be the select component trigger but got ${document.activeElement}`);

package/src/table.ts

@@ -11,10 +11,11 @@
  */
 
 import {act, waitFor, within} from '@testing-library/react';
+import {BaseGridRowInteractionOpts, GridRowActionOpts, TableTesterOpts, ToggleGridRowOpts, UserOpts} from './types';
 import {getAltKey, getMetaKey, pressElement, triggerLongPress} from './events';
-import {GridRowActionOpts, TableTesterOpts, ToggleGridRowOpts, UserOpts} from './types';
 
 interface TableToggleRowOpts extends ToggleGridRowOpts {}
+interface TableToggleExpansionOpts extends BaseGridRowInteractionOpts {}
 interface TableToggleSortOpts {
   /**
    * The index, text, or node of the column to toggle selection for.
@@ -162,6 +163,50 @@ export class TableTester {
     }
   };
 
+  /**
+   * Toggles the expansion for the specified tree row. Defaults to using the interaction type set on the tree tester.
+   */
+  async toggleRowExpansion(opts: TableToggleExpansionOpts): Promise<void> {
+    let {
+      row,
+      interactionType = this._interactionType
+    } = opts;
+    if (!this.table.contains(document.activeElement)) {
+      await act(async () => {
+        this.table.focus();
+      });
+    }
+
+    if (typeof row === 'string' || typeof row === 'number') {
+      row = this.findRow({rowIndexOrText: row});
+    }
+
+    if (!row) {
+      throw new Error('Target row not found in the table.');
+    } else if (row.getAttribute('aria-expanded') == null) {
+      throw new Error('Target row is not expandable.');
+    }
+
+    if (interactionType === 'mouse' || interactionType === 'touch') {
+      let rowExpander = within(row).getAllByRole('button')[0]; // what happens if the button is not first? how can we differentiate?
+      await pressElement(this.user, rowExpander, interactionType);
+    } else if (interactionType === 'keyboard') {
+      if (row?.getAttribute('aria-disabled') === 'true') {
+        return;
+      }
+
+      // TODO: We always Use Option/Ctrl when keyboard navigating so selection isn't changed
+      // in selectionmode="replace"/highlight selection when navigating to the row that the user wants
+      // to expand. Discuss if this is useful or not
+      await this.keyboardNavigateToRow({row});
+      if (row.getAttribute('aria-expanded') === 'true') {
+        await this.user.keyboard('[ArrowLeft]');
+      } else {
+        await this.user.keyboard('[ArrowRight]');
+      }
+    }
+  };
+
   /**
    * Toggles the sort order for the specified table column. Defaults to using the interaction type set on the table tester.
    */

package/src/tabs.ts

@@ -79,6 +79,11 @@ export class TabsTester {
   private async keyboardNavigateToTab(opts: {tab: HTMLElement, orientation?: Orientation}) {
     let {tab, orientation = 'vertical'} = opts;
     let tabs = this.tabs;
+    tabs = tabs.filter(tab => !(tab.hasAttribute('disabled') || tab.getAttribute('aria-disabled') === 'true'));
+    if (tabs.length === 0) {
+      throw new Error('Tablist doesnt have any non-disabled tabs. Please double check your tabs implementation.');
+    }
+
     let targetIndex = tabs.indexOf(tab);
     if (targetIndex === -1) {
       throw new Error('Tab provided is not in the tablist');
@@ -89,11 +94,11 @@ export class TabsTester {
       if (selectedTab != null) {
         act(() => selectedTab.focus());
       } else {
-        act(() => tabs.find(tab => !(tab.hasAttribute('disabled') || tab.getAttribute('aria-disabled') === 'true'))?.focus());
+        act(() => tabs[0]?.focus());
       }
     }
 
-    let currIndex = this.tabs.indexOf(document.activeElement as HTMLElement);
+    let currIndex = tabs.indexOf(document.activeElement as HTMLElement);
     if (currIndex === -1) {
       throw new Error('ActiveElement is not in the tablist');
     }

package/src/testSetup.ts

@@ -35,35 +35,37 @@ export function installMouseEvent(): void {
   });
 }
 
+export function definePointerEvent(): void {
+  // @ts-ignore
+  global.PointerEvent = class FakePointerEvent extends MouseEvent {
+    _init: {pageX: number, pageY: number, pointerType: string, pointerId: number, width: number, height: number};
+    constructor(name, init) {
+      super(name, init);
+      this._init = init;
+    }
+    get pointerType() {
+      return this._init.pointerType ?? 'mouse';
+    }
+    get pointerId() {
+      return this._init.pointerId;
+    }
+    get pageX() {
+      return this._init.pageX;
+    }
+    get pageY() {
+      return this._init.pageY;
+    }
+    get width() {
+      return this._init.width;
+    }
+    get height() {
+      return this._init.height;
+    }
+  };
+}
+
 export function installPointerEvent(): void {
-  beforeAll(() => {
-    // @ts-ignore
-    global.PointerEvent = class FakePointerEvent extends MouseEvent {
-      _init: {pageX: number, pageY: number, pointerType: string, pointerId: number, width: number, height: number};
-      constructor(name, init) {
-        super(name, init);
-        this._init = init;
-      }
-      get pointerType() {
-        return this._init.pointerType ?? 'mouse';
-      }
-      get pointerId() {
-        return this._init.pointerId;
-      }
-      get pageX() {
-        return this._init.pageX;
-      }
-      get pageY() {
-        return this._init.pageY;
-      }
-      get width() {
-        return this._init.width;
-      }
-      get height() {
-        return this._init.height;
-      }
-    };
-  });
+  beforeAll(definePointerEvent);
   afterAll(() => {
     // @ts-ignore
     delete global.PointerEvent;

package/src/types.ts

@@ -39,6 +39,8 @@ export interface BaseTesterOpts extends UserOpts {
   root: HTMLElement
 }
 
+export interface CheckboxGroupTesterOpts extends BaseTesterOpts {}
+
 export interface ComboBoxTesterOpts extends BaseTesterOpts {
   /**
    * The base element for the combobox. If provided the wrapping element around the target combobox (as is the the case with a ref provided to RSP ComboBox),
@@ -52,6 +54,17 @@ export interface ComboBoxTesterOpts extends BaseTesterOpts {
   trigger?: HTMLElement
 }
 
+export interface DialogTesterOpts extends BaseTesterOpts {
+  /**
+   * The trigger element for the dialog.
+   */
+  root: HTMLElement,
+  /**
+   * The overlay type of the dialog. Used to inform the tester how to find the dialog.
+   */
+  overlayType?: 'modal' | 'popover'
+}
+
 export interface GridListTesterOpts extends BaseTesterOpts {}
 
 export interface ListBoxTesterOpts extends BaseTesterOpts {
@@ -76,6 +89,14 @@ export interface MenuTesterOpts extends BaseTesterOpts {
   rootMenu?: HTMLElement
 }
 
+export interface RadioGroupTesterOpts extends BaseTesterOpts {
+  /**
+   * The horizontal layout direction, typically affected by locale.
+   * @default 'ltr'
+   */
+  direction?: Direction
+}
+
 export interface SelectTesterOpts extends BaseTesterOpts {
   /**
    * The trigger element for the select. If provided the wrapping element around the target select (as is the case with a ref provided to RSP Select),

package/src/user.ts

@@ -10,22 +10,28 @@
  * governing permissions and limitations under the License.
  */
 
-import {ComboBoxTester} from './combobox';
+import {CheckboxGroupTester} from './checkboxgroup';
 import {
+  CheckboxGroupTesterOpts,
   ComboBoxTesterOpts,
+  DialogTesterOpts,
   GridListTesterOpts,
   ListBoxTesterOpts,
   MenuTesterOpts,
+  RadioGroupTesterOpts,
   SelectTesterOpts,
   TableTesterOpts,
   TabsTesterOpts,
   TreeTesterOpts,
   UserOpts
 } from './types';
+import {ComboBoxTester} from './combobox';
+import {DialogTester} from './dialog';
 import {GridListTester} from './gridlist';
 import {ListBoxTester} from './listbox';
 import {MenuTester} from './menu';
 import {pointerMap} from './';
+import {RadioGroupTester} from './radiogroup';
 import {SelectTester} from './select';
 import {TableTester} from './table';
 import {TabsTester} from './tabs';
@@ -33,21 +39,27 @@ import {TreeTester} from './tree';
 import userEvent from '@testing-library/user-event';
 
 let keyToUtil: {
-  'Select': typeof SelectTester,
-  'Table': typeof TableTester,
-  'Menu': typeof MenuTester,
+  'CheckboxGroup': typeof CheckboxGroupTester,
   'ComboBox': typeof ComboBoxTester,
+  'Dialog': typeof DialogTester,
   'GridList': typeof GridListTester,
   'ListBox': typeof ListBoxTester,
+  'Menu': typeof MenuTester,
+  'RadioGroup': typeof RadioGroupTester,
+  'Select': typeof SelectTester,
+  'Table': typeof TableTester,
   'Tabs': typeof TabsTester,
   'Tree': typeof TreeTester
 } = {
-  'Select': SelectTester,
-  'Table': TableTester,
-  'Menu': MenuTester,
+  'CheckboxGroup': CheckboxGroupTester,
   'ComboBox': ComboBoxTester,
+  'Dialog': DialogTester,
   'GridList': GridListTester,
   'ListBox': ListBoxTester,
+  'Menu': MenuTester,
+  'RadioGroup': RadioGroupTester,
+  'Select': SelectTester,
+  'Table': TableTester,
   'Tabs': TabsTester,
   'Tree': TreeTester
 } as const;
@@ -55,10 +67,13 @@ export type PatternNames = keyof typeof keyToUtil;
 
 // Conditional type: https://www.typescriptlang.org/docs/handbook/2/conditional-types.html
 type Tester<T> =
+  T extends 'CheckboxGroup' ? CheckboxGroupTester :
   T extends 'ComboBox' ? ComboBoxTester :
+  T extends 'Dialog' ? DialogTester :
   T extends 'GridList' ? GridListTester :
   T extends 'ListBox' ? ListBoxTester :
   T extends 'Menu' ? MenuTester :
+  T extends 'RadioGroup' ? RadioGroupTester :
   T extends 'Select' ? SelectTester :
   T extends 'Table' ? TableTester :
   T extends 'Tabs' ? TabsTester :
@@ -66,10 +81,13 @@ type Tester<T> =
   never;
 
 type TesterOpts<T> =
+  T extends 'CheckboxGroup' ? CheckboxGroupTesterOpts :
   T extends 'ComboBox' ? ComboBoxTesterOpts :
+  T extends 'Dialog' ? DialogTesterOpts :
   T extends 'GridList' ? GridListTesterOpts :
   T extends 'ListBox' ? ListBoxTesterOpts :
   T extends 'Menu' ? MenuTesterOpts :
+  T extends 'RadioGroup' ? RadioGroupTesterOpts :
   T extends 'Select' ? SelectTesterOpts :
   T extends 'Table' ? TableTesterOpts :
   T extends 'Tabs' ? TabsTesterOpts :

package/dist/combobox.main.js.map

@@ -1 +0,0 @@
-{"mappings":"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","sources":["packages/@react-aria/test-utils/src/combobox.ts"],"sourcesContent":["/*\n * Copyright 2024 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport {act, waitFor, within} from '@testing-library/react';\nimport {ComboBoxTesterOpts, UserOpts} from './types';\n\ninterface ComboBoxOpenOpts {\n  /**\n   * Whether the combobox opens on focus or needs to be manually opened via user action.\n   * @default 'manual'\n   */\n  triggerBehavior?: 'focus' | 'manual',\n  /**\n   * What interaction type to use when opening the combobox. Defaults to the interaction type set on the tester.\n   */\n  interactionType?: UserOpts['interactionType']\n}\n\ninterface ComboBoxSelectOpts extends ComboBoxOpenOpts {\n  /**\n   * The index, text, or node of the option to select. Option nodes can be sourced via `options()`.\n   */\n  option: number | string | HTMLElement\n}\n\nexport class ComboBoxTester {\n  private user;\n  private _interactionType: UserOpts['interactionType'];\n  private _combobox: HTMLElement;\n  private _trigger: HTMLElement;\n\n  constructor(opts: ComboBoxTesterOpts) {\n    let {root, trigger, user, interactionType} = opts;\n    this.user = user;\n    this._interactionType = interactionType || 'mouse';\n\n    // Handle case where element provided is a wrapper around the combobox. The expectation is that the user at least uses a ref/data attribute to\n    // query their combobox/combobox wrapper (in the case of RSP) which they then pass to thhis\n    this._combobox = root;\n    let combobox = within(root).queryByRole('combobox');\n    if (combobox) {\n      this._combobox = combobox;\n    }\n\n    // This is for if user need to directly set the trigger button element (aka the element provided in setElement was the combobox input or the trigger is somewhere unexpected)\n    if (trigger) {\n      this._trigger = trigger;\n    } else {\n      let buttons = within(root).queryAllByRole('button', {hidden: true});\n\n      if (buttons.length === 1) {\n        trigger = buttons[0];\n      } else if (buttons.length > 1) {\n        trigger = buttons.find(button => button.hasAttribute('aria-haspopup'));\n      }\n\n      // For cases like https://www.w3.org/WAI/ARIA/apg/patterns/combobox/examples/combobox-select-only/ where the combobox\n      // is also the trigger button\n      this._trigger = trigger || this._combobox;\n    }\n  }\n\n  /**\n   * Set the interaction type used by the combobox tester.\n   */\n  setInteractionType(type: UserOpts['interactionType']): void {\n    this._interactionType = type;\n  }\n\n  /**\n   * Opens the combobox dropdown. Defaults to using the interaction type set on the combobox tester.\n   */\n  async open(opts: ComboBoxOpenOpts = {}): Promise<void> {\n    let {triggerBehavior = 'manual', interactionType = this._interactionType} = opts;\n    let trigger = this.trigger;\n    let combobox = this.combobox;\n    let isDisabled = trigger!.hasAttribute('disabled');\n\n    if (interactionType === 'mouse') {\n      if (triggerBehavior === 'focus') {\n        await this.user.click(combobox);\n      } else {\n        await this.user.click(trigger);\n      }\n    } else if (interactionType === 'keyboard' && this._trigger != null) {\n      act(() => this._trigger!.focus());\n      if (triggerBehavior !== 'focus') {\n        await this.user.keyboard('{ArrowDown}');\n      }\n    } else if (interactionType === 'touch') {\n      if (triggerBehavior === 'focus') {\n        await this.user.pointer({target: combobox, keys: '[TouchA]'});\n      } else {\n        await this.user.pointer({target: trigger, keys: '[TouchA]'});\n      }\n    }\n\n    await waitFor(() => {\n      if (!isDisabled && combobox.getAttribute('aria-controls') == null) {\n        throw new Error('No aria-controls found on combobox trigger element.');\n      } else {\n        return true;\n      }\n    });\n    let listBoxId = combobox.getAttribute('aria-controls');\n    await waitFor(() => {\n      if (!isDisabled && (!listBoxId || document.getElementById(listBoxId) == null)) {\n        throw new Error(`Listbox with id of ${listBoxId} not found in document.`);\n      } else {\n        return true;\n      }\n    });\n  }\n\n  /**\n   * Returns an option matching the specified index or text content.\n   */\n  findOption(opts: {optionIndexOrText: number | string}): HTMLElement {\n    let {\n      optionIndexOrText\n    } = opts;\n\n    let option;\n    let options = this.options();\n    let listbox = this.listbox;\n\n    if (typeof optionIndexOrText === 'number') {\n      option = options[optionIndexOrText];\n    } else if (typeof optionIndexOrText === 'string' && listbox != null) {\n      option = (within(listbox!).getByText(optionIndexOrText).closest('[role=option]'))! as HTMLElement;\n    }\n\n    return option;\n  }\n\n  /**\n   * Selects the desired combobox option. Defaults to using the interaction type set on the combobox tester. If necessary, will open the combobox dropdown beforehand.\n   * The desired option can be targeted via the option's node, the option's text, or the option's index.\n   */\n  async selectOption(opts: ComboBoxSelectOpts): Promise<void> {\n    let {option, triggerBehavior, interactionType = this._interactionType} = opts;\n    if (!this.combobox.getAttribute('aria-controls')) {\n      await this.open({triggerBehavior});\n    }\n\n    let listbox = this.listbox;\n    if (!listbox) {\n      throw new Error('Combobox\\'s listbox not found.');\n    }\n\n    if (listbox) {\n      if (typeof option === 'string' || typeof option === 'number') {\n        option = this.findOption({optionIndexOrText: option});\n      }\n\n      if (!option) {\n        throw new Error('Target option not found in the listbox.');\n      }\n\n      // TODO: keyboard method of selecting the the option is a bit tricky unless I simply simulate the user pressing the down arrow\n      // the required amount of times to reach the option. For now just click the option even in keyboard mode\n      if (interactionType === 'mouse' || interactionType === 'keyboard') {\n        await this.user.click(option);\n      } else {\n        await this.user.pointer({target: option, keys: '[TouchA]'});\n      }\n\n      if (option.getAttribute('href') == null) {\n        await waitFor(() => {\n          if (document.contains(listbox)) {\n            throw new Error('Expected listbox element to not be in the document after selecting an option');\n          } else {\n            return true;\n          }\n        });\n      }\n    } else {\n      throw new Error(\"Attempted to select a option in the combobox, but the listbox wasn't found.\");\n    }\n  }\n\n  /**\n   * Closes the combobox dropdown.\n   */\n  async close(): Promise<void> {\n    let listbox = this.listbox;\n    if (listbox) {\n      act(() => this.combobox.focus());\n      await this.user.keyboard('[Escape]');\n\n      await waitFor(() => {\n        if (document.contains(listbox)) {\n          throw new Error('Expected listbox element to not be in the document after selecting an option');\n        } else {\n          return true;\n        }\n      });\n    }\n  }\n\n  /**\n   * Returns the combobox.\n   */\n  get combobox(): HTMLElement {\n    return this._combobox;\n  }\n\n  /**\n   * Returns the combobox trigger button.\n   */\n  get trigger(): HTMLElement {\n    return this._trigger;\n  }\n\n  /**\n   * Returns the combobox's listbox if present.\n   */\n  get listbox(): HTMLElement | null {\n    let listBoxId = this.combobox.getAttribute('aria-controls');\n    return listBoxId ? document.getElementById(listBoxId) || null : null;\n  }\n\n  /**\n   * Returns the combobox's sections if present.\n   */\n  get sections(): HTMLElement[] {\n    let listbox = this.listbox;\n    return listbox ? within(listbox).queryAllByRole('group') : [];\n  }\n\n  /**\n   * Returns the combobox's options if present. Can be filtered to a subsection of the listbox if provided via `element`.\n   */\n  options(opts: {element?: HTMLElement} = {}): HTMLElement[] {\n    let {element = this.listbox} = opts;\n    let options = [];\n    if (element) {\n      options = within(element).queryAllByRole('option');\n    }\n\n    return options;\n  }\n\n  /**\n   * Returns the currently focused option in the combobox's dropdown if any.\n   */\n  get focusedOption(): HTMLElement | null {\n    let focusedOptionId = this.combobox.getAttribute('aria-activedescendant');\n    return focusedOptionId ? document.getElementById(focusedOptionId) : null;\n  }\n}\n"],"names":[],"version":3,"file":"combobox.main.js.map"}