Add option to *ByText to search by innerText

[steinybot]

Describe the feature you'd like:

I'd like to have an includeDescendents option to *ByText which would effectively be the same as searching by innerText (but it's not that simple since it needs to respect the ignore option).

I'm new to testing-library and have more familiarity with Cypress. I was hoping to find similar behaviour to cy.contains.

Suggested implementation:

Describe alternatives you've considered:

cy.contains but this is always an { exact: false} match which is usually less than ideal.

Teachability, Documentation, Adoption, Migration Strategy:

Given this:

      <p>
        Refer to the
        <a
          href="https://testing-library.com/docs/dom-testing-library/api-custom-queries"
          >Custom Queries</a
        >
        section for more details.
      </p>

Then this:

findByText('Refer to the Custom Queries section for more details.', { includeDescendents: true })

Should match the p node.

[MatanBobi]

As a general idea, the getBy* queries can accept a function that will be called for every element you're rendering and let you query the way you want.
You can have a look at this solution that searches for textContent and gives you the direct parent that has the content you're looking for. Hope it will help :)

[marcelhohn]

+1 for this, since this is the behavior I was expecting when reading the docs:

This will search for all elements that have a text node with textContent matching the given TextMatch.

In the above example the textContent of the p node is "Refer to the Custom Queries section for more details.", so I would expect findByText to match the p node.

Or at least the docs should be update imho.