playwright-bdd

Run BDD tests with Playwright runner.

Inspired by the issue in the Playwright repo microsoft/playwright#11975

[!TIP] Playwright-bdd v7 is released! Dropped Cucumber package dependency, simpler configuration and other improvements. Try it out and share the feedback!

Why Playwright runner?

Both Playwright and CucumberJS have their own test runners. You can use CucumberJS runner with Playwright as a library to test BDD scenarios. This package offers an alternative way: convert BDD scenarios into Playwright tests and run them with Playwright runner as usual. Such approach brings all the benefits of Playwright runner:

• Automatic browser initialization and cleanup
• Auto-capture of screenshots, videos and traces
• Parallelization with sharding
• Auto-waiting of page elements
• Out-of-box visual comparison testing
• Power of Playwright fixtures
• ...a lot more

Extras

Some features were developed in playwright-bdd on top of Playwright and BDD approaches:

• Decorator steps
• Special tags
• Calling step from step

Documentation

Check out documentation website.

Examples

There are several examples in examples folder and a separate fully working repo playwright-bdd-example.

Community

Let's make playwright-bdd awesome together!

• Open an issue on GitHub to report bug or propose new feature
• 🆕 Join Playwright-bdd Discord Server to connect with other developers, ask questions and share your experience or showcase

Changelog

Check out the latest changes in the CHANGELOG.md.

Contributing

Your contributions are welcome! Review DEVELOPMENT.md for playwright-bdd local setup and development.

Sponsors

Great thanks to the sponsors for supporting playwright-bdd project ❤️ Become a sponsor

How to make BDD valuable for my project?

Have a look on this section.

My other Playwright tools

• playwright-network-cache - Speed up Playwright tests by caching network requests on the filesystem.
• playwright-magic-steps - Auto-transform JavaScript comments into Playwright steps.

License

MIT