Allow queries to take optional filter function

Describe the feature you’d like:

A common pattern that I’ve been using is:

const element = getByText(...);
expect(element).toBeVisible();

However, it may be the case that there are invisible elements that match the first selector, leading to a thrown error since multiple elements were found. It would be much nicer to be able to write something like:

const element = getByText(..., {filter: isVisible}); // It would also be nice for jest-dom to export `isVisible`

Describe alternatives you’ve considered:

If theisVisible use-case is by far the most common, then it could be sufficient to export queryVisibleBy* methods directly.

[mhess]

I also end up waiting on a button to become enabled a lot like this:

let button;
await waitFor(() => {
  button = screen.getByRole('button', {name: 'foo'});
  expect(button).toBeEnabled()
});
userEvent.click(button);

I would find a lot of value in either a interface like @juanca proposed

await screen.findByLabelText('some button', { filter: (element) => !!element.disabled });

or adding an option to waitFor that only runs the callback on dom mutations

[nickmccurdy]

I believe this was a comment on getByRole https://github.com/testing-library/dom-testing-library/issues/684#issuecomment-655203800