fireEvent missing documentation and requires unnecessary element reference

[jakst]

• dom-testing-library version: 3.12.0 (RTL 5.1.0)
• react version: 16.7.0
• node version: -
• npm (or yarn) version: yarn 1.12.1

Problem description:

Events like fireEvent.keyDown don't have any documentation.

The obvious way (for me at least) to fire these events would be fireEvent.keyDown('Enter'), but through looking at the code I found out that you have to do fireEvent.keyDown(someElement, { key: 'Enter' }), where someElement can be any element on the page, and is therefore very unintuitive. Key events really have no connection to an element.

Could this be, if not changed, at least clarified in documentation here and in react-testing-library?

[kentcdodds]

This is a great point @jakst! It'd be great to get improved documentation on what events are available and the typical way to use them. Would you like to open a pull request to add that to the README? Thanks!

[jakst]

I could, but I'm not really sure how to handle documentation of the random element. Just be honest about the randomness until a better fix is finished?

[kentcdodds]

@jakst, I think you misunderstand. Every event on the page must have some target. Even if that target is document.body.