React Test Renderer：使用 findAll 精确查找元素

React Test Renderer 提供了一种在不依赖浏览器或 DOM 环境的情况下渲染 React 组件的方法，这使得编写快速、隔离的单元测试成为可能。 然而，其内置的查找 API 可能不够灵活，无法满足所有测试需求，特别是当需要根据类名精确定位元素时。

如摘要所述，本文将介绍如何使用 findAll 方法结合自定义选择器函数，通过类名精确查找 React Test Renderer 中的元素。

自定义选择器函数

核心思想是创建一个函数，该函数接收一个选择器字符串作为参数，并返回一个谓词函数。 这个谓词函数将接收一个 ReactTestInstance 作为参数，并根据该实例是否匹配选择器返回 true 或 false。

以下是一个示例选择器函数：

import { ReactTestInstance } from 'react-test-renderer';
function testSelector(selector = ''): (instance: ReactTestInstance) => boolean {
const [type, ...classNames] = selector.split('.');
return instance => {
if (type && instance.type !== type) {
return false;
}
const {className = ''} = instance.props;
const instanceClassNames = (className as string).split(' ');
return classNames.every(className => instanceClassNames.includes(className));
};
}

这个 testSelector 函数的工作原理如下：

1. 解析选择器： 它首先将选择器字符串按 . 分割成类型和类名。 例如，如果选择器是 ‘span.footer_link’，则 type 将是 ‘span’，classNames 将是 [‘footer_link’]。

2. 返回谓词函数： 它返回一个函数，该函数接收 ReactTestInstance 作为输入。

3. 类型检查（可选）： 谓词函数首先检查实例的 type 是否与选择器中指定的类型匹配。 如果类型不匹配，则立即返回 false。 如果选择器中没有指定类型（例如，选择器是 ‘.footer_link’），则跳过此检查。

4. 类名检查： 然后，它获取实例的 className 属性，并将其分割成一个类名数组。

5. 精确匹配： 最后，它使用 every 方法来确保选择器中指定的所有类名都存在于实例的类名数组中。只有当所有类名都匹配时，谓词函数才返回 true。

使用 findAll 和自定义选择器

现在，我们可以使用 findAll 方法和自定义的 testSelector 函数来查找具有特定类名的元素。

以下是一个示例：

import { create } from 'react-test-renderer';
import Footer from './Footer'; // 假设 Footer 组件位于 ./Footer.js
import { ReactTestInstance } from 'react-test-renderer';
function testSelector(selector = ''): (instance: ReactTestInstance) => boolean {
const [type, ...classNames] = selector.split('.');
return instance => {
if (type && instance.type !== type) {
return false;
}
const {className = ''} = instance.props;
const instanceClassNames = (className as string).split(' ');
return classNames.every(className => instanceClassNames.includes(className));
};
}
it('finds elements by classname', () => {
const component = create();
expect(component.root.findAll(testSelector('span.footer_link')).length).toBe(2);
});

在这个例子中，我们首先使用 create 函数渲染 Footer 组件。然后，我们使用 component.root.findAll(testSelector(‘span.footer_link’)) 来查找所有类名为 footer_link 的 span 元素。 最后，我们使用 expect 断言找到的元素数量是否为 2。

注意事项

• 性能： findAll 方法会遍历整个渲染树，因此在大型组件树中使用时可能会影响性能。 尽量避免在每次测试中都遍历整个树，而是专注于测试特定的组件及其子组件。

• 选择器的精确性： 确保选择器足够精确，以避免找到不相关的元素。 例如，如果只想查找 Footer 组件中的 footer_link 类，则可以使用更具体的选择器，例如 ‘Footer span.footer_link’（假设 Footer 组件有一个根元素）。

• 组件结构： 这种方法依赖于组件的内部结构。 如果组件的结构发生变化（例如，类名被更改或元素被移动），则测试可能会失败。 因此，需要定期维护测试，以确保它们与组件的实际结构保持同步。

总结

通过结合 findAll 方法和自定义选择器函数，可以有效地使用 React Test Renderer 通过类名查找元素。 这种方法使编写更精确、更可靠的 UI 测试成为可能，从而确保组件按预期渲染和行为。 记住，编写清晰、简洁的测试对于维护高质量的代码库至关重要。