Get accessible name from element

[dmurvihill]

In keeping with Guiding Principle #2, I would like to assert what accessible name will be emitted for an element by screen readers and such. Currently this task, which all users of testing-library should be doing, requires implementing a very complicated algorithm or relying on a third-party dependency like the archived accname package.

Suggested implementation:

getAccessibleName(myElement)

Workaround:

expect(screen.getByRole('button', { name: expectedName })).toBe(myElement);

This gives the correct result, but in the failure case the debugging information is unsatisfactory ("expected x, received null" instead of showing the expected and actual name side-by-side).

[MatanBobi]

We're using the dom-accessibility-api package for that. Exporting it is just an implementation detail, the workaround you presented is actually what we want people to do. You can install dom-accessibility-api for it :)

[dmurvihill]

Thanks, that's very helpful. Do you think you could mention this in the docs? That package is hard to find by Web searching atm.