Method triggerTab

packages/@react-aria/test-utils/src/tabs.ts:129–158

* Triggers the specified tab. Defaults to using the interaction type set on the tabs tester.

(opts: TriggerTabOptions)

   * Triggers the specified tab. Defaults to using the interaction type set on the tabs tester.
   */
  async triggerTab(opts: TriggerTabOptions): Promise<void> {
    let {tab, interactionType = this._interactionType, manualActivation} = opts;

    if (typeof tab === 'string' || typeof tab === 'number') {
      tab = this.findTab({indexOrText: tab});
    }

    if (!tab) {
      throw new Error(`Target tab "${formatTargetNode(opts.tab)}" not found in the tablist.`);
    } else if (tab.hasAttribute('disabled')) {
      throw new Error(`Target tab "${formatTargetNode(opts.tab)}" is disabled.`);
    }

    if (interactionType === 'keyboard') {
      if (
        document.activeElement !== this._tablist &&
        !this._tablist.contains(document.activeElement)
      ) {
        act(() => this._tablist.focus());
      }

      let tabsOrientation = this._tablist.getAttribute('aria-orientation') || 'horizontal';
      await this.keyboardNavigateToTab({tab, orientation: tabsOrientation as Orientation});
      if (manualActivation) {
        await this.user.keyboard('[Enter]');
      }
    } else {
      await pressElement(this.user, tab, interactionType);
    }
  }

  /**
   * Returns the tablist.