Par texte

[Traduction Bêta Non Officielle]

Cette page a été traduite par PageTurner AI (bêta). Non approuvée officiellement par le projet. Vous avez trouvé une erreur ? Signaler un problème →

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

Cette requête recherche tous les éléments possédant un nœud texte dont le textContent correspond au TextMatch spécifié.

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

Native

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)

Angular

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

await render(MyComponent)
const aboutAnchorNode = screen.getByText(/about/i)

Cypress

cy.findByText(/about/i).should('exist')

Elle fonctionne également avec les input dont l'attribut type vaut submit ou button :

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

Options

Options de TextMatch, plus les suivantes :

selector

Remarque

Consultez getByLabelText pour plus de détails sur l'utilisation de l'option selector

ignore

L'option ignore accepte un sélecteur de requête. Si node.matches renvoie true pour ce sélecteur, le nœud sera ignoré. Par défaut, cette option vaut 'script, style' car ces balises sont généralement exclues, mais si votre contenu se trouve dans un script en ligne, la balise script pourrait être retournée.

Pour désactiver ce comportement, définissez ignore sur false.