Add createEvent that returns the created Event

[dbismut]

What:

Exposes a utility to create events that can be thrown by fireEvent. This is useful in order to have access to the source event attributes see #257

Why:

Some components might rely on event attributes created when the event object is created (i.e. new Event({...eventAttributes})).

How:

As suggested by @kentcdodds in #257:

import {createEvent} from 'dom-testing-library'

const myEvent = createEvent.click(node, eventAttributes)
fireEvent(node, myEvent)

However since the event constructor depends on window which itself depends on the node, createEvent also requires the node to be passed as an argument (not very elegant I admit).

Checklist:

• Documentation added to the docs site
• Typescript definitions updated
• Tests: since fireEvent now uses createEvent I believe successful tests on fireEvent cover createEvent
• Ready to be merged

Pre-commit hook threw an error on Typescript definitions but I'm really not sure what's wrong, so I committed with the --no-verify flag.

[kentcdodds]

Looks good to me other than one comment

[kentcdodds]

Could you revert these changes?

[dbismut]

Humpf sorry. I was trying to see what was wrong with my commit on typescript definitions...

[kentcdodds]

Excellent 💯

[kentcdodds]

Could you make a pull request to the docs site to add documentation?

[kentcdodds]

@allcontributors[bot] please add @dbismut for code

[allcontributors]

@kentcdodds

I've put up a pull request to add @dbismut! 🎉

[kentcdodds]

🎉 This PR is included in version 4.1.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀

[dbismut]

Yes I will PR the docs (although my English might be shaky)! Is it necessary to add createEvent as an export to react-testing-library?

[kentcdodds]

react-testing-library re-experts everything from dom-testing-library so we're good there 👍