add BeforeStep / AfterStep hooks

[the3dsandwich]

As discussed in #280

The BeforeStep and AfterStep hooks will enable code to be run before each Given, When, Then, etc. steps.

This way, we will be able to attach screenshots for every step.

[vitalets]

Let's add a test for step hooks in a new folder test/hooks-step. You can use test/hooks-order-one-feature as a reference. To run this particular test: npm run only test/hooks-step.

[the3dsandwich]

Let's add a test for step hooks in a new folder test/hooks-step. You can use test/hooks-order-one-feature as a reference. To run this particular test: npm run only test/hooks-step.

I added test/hook-step, renamed use to result, and renamed getHookStepTitle to BeforeStep/AfterStep.

regarding enabling page fixture in addition to common this.bddContext, any idea how we can proceed?

[vitalets]

I've updated test/hooks-step a bit: removed scenario and worker hooks. Pushed the changes to your branch, so it's in the pr.
Now let me think a bit how to pass fixtures to the step hooks. Will post updates here.

[the3dsandwich]

I found that I haven't changed StepHookType from ScenarioHookType. Renaming in this commit.

[vitalets]

Hi @the3dsandwich

I've pushed the fix for passing fixtures to step hooks, on top of your last commit.
Now we only need to write the docs about step hooks.

• describe in the Hooks section
• add to API section

Are you willing to contribute to the docs as well?
If yes, you can run npm run docs and check edits locally.

[the3dsandwich]

Working on it. Will push something ASAP

[the3dsandwich]

I wasn't aware that tagging exist, so I'm unsure whether I got that part of the documentation right. Would you mind double-checking the contents are accurate?
In terms of docsify, did you install via npm i -g docsify?

[vitalets]

What is this file for?

[the3dsandwich]

My bad. I should have left this file out of the commit. It's to specify that this repo uses node 20 for this tool https://moonrepo.dev/proto

[vitalets]

@the3dsandwich in your scenario with screenshots, if step fails do you expect the AfterStep still run?

[the3dsandwich]

I personally do not expect AfterStep to run if a step fails and throws an error. If I want a screenshot of failed tests I would add it to the playwright config, or use a fixture to edit the title or something.

[the3dsandwich]

I updated the docs a bit further, so that the example of taking a screenshot after every step is in the AfterStep block.