ByAltText

getByAltText, queryByAltText, getAllByAltText, queryAllByAltText, findByAltText, findAllByAltText

API

getByAltText(
  // If you're using `screen`, then skip the container argument:
  container: HTMLElement,
  text: TextMatch,
  options?: {
    exact?: boolean = true,
    normalizer?: NormalizerFn,
  }): HTMLElement

返回匹配指定 alt 文本的元素 (通常是一个 <img>) 。请注意，它仅支持接受 alt 属性的元素或 自定义元素 (因为我们不知道自定义元素是否实现了 alt): <img>, <input>, 和 <area> (故意 排除 <applet>， 因为它已经被弃用).

<img alt="Incredibles 2 Poster" src="/incredibles-2.png" />

Native

import {screen} from '@testing-library/dom'

const incrediblesPosterImg = screen.getByAltText(/incredibles.*? poster/i)

React

import {render, screen} from '@testing-library/react'

render(<MyComponent />)
const incrediblesPosterImg = screen.getByAltText(/incredibles.*? poster/i)

Cypress

cy.findByAltText(/incredibles.*? poster/i).should('exist')

选项

TextMatch 选项