使用@testing-library/react测试select下拉选项点击的实现方法
问题根因
你遇到的测试异常和useRef无关,核心是三个认知偏差:
- 测试环境jsdom和真实浏览器的DOM实现存在差异:react-scripts 4.0.1自带的jsdom 16.x版本中,原生
<select>元素的子<option>节点是通过元素自带的options属性独立维护的,直接读取element.children返回的HTMLCollection存在枚举不全的问题,所以你拿到空集合不代表options没有被正确渲染。 - 你在浏览器控制台写的DOM选择器存在语法错误:
document.querySelector('toolbar-toggler')是标签选择器写法,实际要匹配类名为toolbar-toggler的节点需要写document.querySelector('.toolbar-toggler'),之前能拿到option数组是因为你手动定位到了实际DOM节点,并不是这个选择器正常生效。 - 你判断需要用useRef访问options的解决方向存在偏差:useRef的作用是在React组件内部获取DOM元素引用,测试场景下通过@testing-library的查询方法拿到的本身就是真实挂载的DOM节点,自带完整的
options属性,根本不需要通过ref穿透组件内部拿元素。
正确的测试实现方案
按照@testing-library的官方测试逻辑编写即可,不需要给组件加额外的ref逻辑:
- 拿到select元素后,不要通过遍历
children查找option,直接读元素自带的options属性就能拿到所有渲染的选项列表 - 原生select的选中操作,不需要手动模拟点击展开下拉再找option,jsdom环境不会真实渲染浏览器原生的下拉浮层,所有option从组件挂载时就已经作为select的内置选项存在,直接用
@testing-library/user-event提供的selectOptions方法即可完成标准的选中流程,完全匹配用户实际操作的交互逻辑 - 测试代码示例:
// Toolbar.test.tsx import { render, screen } from '@testing-library/react' import userEvent from '@testing-library/user-event' import Toolbar from './Toolbar' test('可以正常选中difficulty分类下的regular选项', async () => { render(<Toolbar />) // 通过label和select的关联关系拿到目标元素 const difficultySelect = screen.getByLabelText('difficulty') // 验证options渲染状态正常 expect(difficultySelect.options).toHaveLength(4) expect(Array.from(difficultySelect.options).map(opt => opt.value)).toContain('regular') // 模拟用户选中值为regular的选项 await userEvent.selectOptions(difficultySelect, 'regular') // 验证选中状态和组件交互逻辑是否正确触发 expect(difficultySelect.value).toBe('regular') })
操作注意事项
- 不要为了测试拿DOM的需求给组件加额外的ref暴露逻辑,@testing-library的设计初衷就是基于用户可感知的界面行为做测试,不需要依赖组件内部的实现细节
- jsdom环境下原生select的
onChange事件,会在selectOptions操作时和真实浏览器一样正常触发,不需要额外做事件mock
内容的提问来源于stack exchange,提问作者Rei Jarram
相关产品推荐
相关产品推荐

