jest-then
v1.0.0
Published
Dumb simple "Given when then" aliases for jest
Downloads
3
Maintainers
Readme
Jest-then
The problem
"describe" and "it" are great, but they don't really speak and guide your thinking during the testing process. Jest-then provides new keywords to help give your tests meaning and differentiate between the Arrange Act Assert part of each test.
What does it look like ?
import "jest-then" // This make given, when, ... available as global variable
Feature( `A user can sign-in`, () => {
Scenario( `Success`, () => {
Given( () => {
// ... pre-conditions for scenario to work
When( authProvider.isAuthenticated() ).thenReturn( false )
When( authProvider.signup( credentials ) ).thenResolve()
} )
Then( `A loader is displayed`, async () => {
// ... code
} )
And( `A success message is passed to the view`, () => {
// ... code
} )
And( `User is redirected to home after a timeout`, async () => {
// ... code
} )
} )
Scenario( `Sign-up error`, () => {
Given( () => {
// ... pre-conditions for scenario to work
When( authProvider.isAuthenticated() ).thenReturn( false )
When( authProvider.signup( credentials ) ).thenReject( error )
} )
Then( `An error message is passed to the view`, async () => {
// ... code
} )
And( `Loader is disabled`, async () => {
// ... code
} )
// ... etc
} )
} )
Available keywords
Note, you can still use their full api. meaning you can use
xscenario
orscenario.only
as you would withdescribe
orit
😇
| Keyword | Alias for |
| ------------- |-------------|
| Scenario | describe |
| Feature | describe|
| Case | describe|
| Given | beforeEach |
| When | beforeEach |
| Then | test/it |
| And | test/it|
But what if jest changes
Under the hood, this thing uses javascript proxies. I only delegate to the original jest object so you're safe 🥳