ByText

getByText, queryByText, getAllByText, queryAllByText, findByText, findAllByText

API​

getByText(// If you're using `screen`, then skip the container argument:container: HTMLElement,text: TextMatch,options?: {selector?: string = '*',exact?: boolean = true,ignore?: string|boolean = 'script, style',normalizer?: NormalizerFn,}): HTMLElement

这将搜索所有具有文本节点并且textContent与给定的TextMatch匹配的元素。

<a href="/about">About ℹ️</a>

 

// HTML
import {screen} from '@testing-library/dom'const aboutAnchorNode = screen.getByText(/about/i)// React
import {render, screen} from '@testing-library/react'render(<MyComponent />)
const aboutAnchorNode = screen.getByText(/about/i)

它也可以与类型为submit或button的输入一起使用：

<input type="submit" value="Send data" />

Options

TextMatch 有以下选项：

selector

有关如何使用和何时使用选择器选项的更多详细信息，请参阅 getByLabelText

ignore

忽略选项接受一个查询选择器。如果 node.matches 对该选择器返回 true，则该节点将被忽略。这默认为 'script, style'，因为通常您不希望选择这些标签，但如果您的内容位于内联脚本文件中，则可能会返回 script 标签。

如果您想禁用此行为，请将 ignore 设置为 false。