ByDisplayValue

[Tradução Beta Não Oficial]

Esta página foi traduzida por PageTurner AI (beta). Não é oficialmente endossada pelo projeto. Encontrou um erro? Reportar problema →

getByDisplayValue, queryByDisplayValue, getAllByDisplayValue, queryAllByDisplayValue, findByDisplayValue, findAllByDisplayValue

API

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

Retorna o elemento input, textarea ou select que possui o valor de exibição correspondente.

Elementos input

<input type="text" id="lastName" />

document.getElementById('lastName').value = 'Norris'

Native

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

const lastNameInput = screen.getByDisplayValue('Norris')

React

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

render(<MyComponent />)
const lastNameInput = screen.getByDisplayValue('Norris')

Angular

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

await render(MyComponent)
const lastNameInput = screen.getByDisplayValue('Norris')

Cypress

cy.findByDisplayValue('Norris').should('exist')

Elementos textarea

<textarea id="messageTextArea" />

document.getElementById('messageTextArea').value = 'Hello World'

Native

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

const messageTextArea = screen.getByDisplayValue('Hello World')

React

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

render(<MyComponent />)
const messageTextArea = screen.getByDisplayValue('Hello World')

Angular

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

await render(MyComponent)
const messageTextArea = screen.getByDisplayValue('Hello World')

Cypress

cy.findByDisplayValue('Hello World').should('exist')

Elementos select

No caso de select, isso irá procurar por um <select> cujo <option> selecionado corresponda ao TextMatch fornecido.

<select>
  <option value="">State</option>
  <option value="AL">Alabama</option>
  <option selected value="AK">Alaska</option>
  <option value="AZ">Arizona</option>
</select>

Native

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

const selectElement = screen.getByDisplayValue('Alaska')

React

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

render(<MyComponent />)
const selectElement = screen.getByDisplayValue('Alaska')

Angular

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

await render(MyComponent)
const selectElement = screen.getByDisplayValue('Alaska')

Cypress

cy.findByDisplayValue('Alaska').should('exist')

Opções

Opções de TextMatch