README

Playwright-BDD

Run BDD tests with Playwright runner

lint test npm version npm downloads license

🚀 Getting Started  📚 Documentation  ▶️ Example  📝 Changelog

BDD in the Era of AI

Behavior-Driven Development (BDD) describes product requirements as Given / When / Then scenarios written in plain text format:

Feature: Buying a pizza

  Scenario: Success order
    Given I am on the "Pepperoni" pizza page
    When I add 2 pizzas to the cart
    And I complete checkout
    Then I see an order confirmation:
      | Product  | Pepperoni  |
      | Quantity | 2          |

In the AI era, these scenarios become valuable artifacts for agents because they are both:

  • ✅ Readable: You can easily draft and refine scenarios with an agent to clearly define the behavior.
  • ✅ Executable: The same scenarios can be executed as automated tests to verify the implementation.

Unlike plain Markdown specs, BDD does not just describe a feature; it makes the spec live and keeps it aligned with the codebase.

Watch the YouTube 1-minute workflow overview or read the blog post to see agentic BDD in action. The ultimate goal: review only feature files and let automated guardrails check code quality and scenario compliance.

To bring this workflow to your project, set up Playwright-BDD and add the playwright-bdd skill for your AI coding agent.

Why Playwright Runner?

Playwright provides both browser automation APIs and a powerful test runner. Playwright-BDD converts .feature files into native Playwright tests, so you can use all Playwright runner capabilities:

  • Automatic browser setup and cleanup
  • Auto-waiting for page elements
  • Auto-capture of screenshots, videos, and traces
  • Parallel execution and sharding
  • Built-in reports and visual comparison testing
  • Playwright fixtures
  • …and more

How It Works

Extras

Playwright-BDD has several unique features:

Documentation

Check out the documentation website.

Demos

Playwright Versions Support

playwright-bdd supports the latest stable Playwright release and the 10 previous releases.

Changelog

Check out the latest changes in the CHANGELOG.md.

💖 Sponsors

Great thanks to the amazing people and companies already supporting Playwright-BDD! Your help keeps the project alive and growing:

Currents

TestMu AI

User avatar: Arturs LeščinskisUser avatar:

If you find Playwright-BDD useful in your personal or work projects, consider becoming a sponsor. Even small contributions help me dedicate more time to maintenance, new features, and community support.

Feedback & Community

Feel free to report a bug, propose a feature or share your experience:

Contributing

Your contributions are welcome! Please review CONTRIBUTING.md for the details.

My Other Playwright tools

License

This project is licensed under the MIT License, allowing you to use, modify, and share the code freely, even for commercial purposes. Enjoy building something amazing! 🎉

评论

暂无评论