Changelog

This project follows the Keep a Changelog format.

Unreleased

• breaking: raise the minimum supported Playwright version from 1.44 to 1.53; support the latest stable minor and 10 previous minor releases.
• feat: support multiple aliases for step definitions
• feat: add native bddgen --watch mode.
• feat: add lockFile option to coordinate multiple bddgen processes.
• fix: generate BDD projects sequentially to prevent concurrent Playwright transform-cache writes from dropping step definitions.

9.2.1 - 2026-09-06

• fix: support Playwright 1.63 by removing obsolete experimental component testing dependencies (#331)

9.2.0 - 2026-06-18

• feat: include CI information in Cucumber reports
• fix: allow disabling step definition arity checks (#392)

9.1.0 - 2026-06-13

• docs: add collapsable sections
• fix: include tags from path in Cucumber reports (#367)
• fix: support Playwright 1.61
• fix: support # title-format comments above tagged Examples blocks (#390)
• fix: run AfterStep after failed steps and expose the step failure via $step.error (#383)

9.0.0 - 2026-06-02

• fix: validate used step definitions with strict Cucumber-compatible arity checks
• feat: add playwright-bdd agent skill for generating Gherkin feature files and step definitions (#377)
• bug: fix non-ASCII characters in text attachments being garbled in the Cucumber HTML report (#379)
• chore: upgrade Cucumber ecosystem dependencies to latest versions
  • @cucumber/messages: 27.x → 32.x — populate Pickle.location and Attachment.timestamp in the messages report
  • @cucumber/gherkin: 32.x → 39.x — Pickle.location is now populated natively by gherkin (since v37)
  • @cucumber/gherkin-utils: 9.x → 11.x
  • @cucumber/cucumber-expressions: 18.x → 19.x
  • @cucumber/tag-expressions: 6.x → 9.x
• reporter: skip attachments by default in the Cucumber JSON reporter
• reporter: make junit the canonical JUnit reporter and deprecate junit-modern alias
• reporter: add JUnit nameFormat option and make Cucumber-compatible testcase naming the default (#375)
• chore: remove deprecated enrichReporterData option
• chore: set minimal Node.js version to 20
• chore: replace fast-glob with tinyglobby (#366)
• perf: limit bddgen worker concurrency to cpus/2 to prevent OOM in memory-constrained CI environments (#376)
• perf: optimize pickle lookup in FeaturesLoader using URI-indexed map (#376)
• feat: doc string media types added to $step fixture as docStringType (#380)
• chore: remove the "Copy Prompt" button from Cucumber HTML report in favor of built-in copy-to-clipboard button.

8.5.1 - 2026-05-12

• fix: support Playwright 1.60+.

8.5.0 - 2026-03-13

• docs: document defineParameterType helper
• cli: improve verbose mode output
• bug: fix Cucumber reporter generation in VS Code runs (#373)
• docs: improve step patterns documentation (#368)

8.4.2 - 2025-11-26

• feat: support multiple step decorators on a single method (#340)
• minor: evaluate Playwright config for better compatibility (#352)
• setup trusted publishing

8.4.1 - 2025-09-03

• feat: explicitly export types (#322, #330)

8.4.0 - 2025-08-22

• improve 'Tags From Path' by excluding the node_modules dir from the feature's extraction method. (#323)
• support Playwright 1.55
• increase minimal Playwright version from 1.42 to 1.44
• sort fixture names deterministically in generated files
• hide in-file BDD fixtures from the report

8.3.1 - 2025-06-20

• bug: enabling aiFix causes dependency cycle (#319)

8.3.0 - 2025-06-05

• fix: improve snippet clearing for Fix with AI
• fix: handle closed page for Fix with AI (#308)
• feat: prioritize steps with tags (#300)
• feat: add junit-modern reporter based on @cucumber/junit-xml-formatter
• feat: update Cucumber HTML reporter with new header block (cucumber/react-components#381)
• chore: remove @cucumber/gherkin-streams dependency in favor of loading features with @cucumber/gherkin
• chore: set minimal Playwright version 1.42
• chore: release via release-it instead of np

8.2.1

• adopt to Playwright 1.51, improve stack trace parsing.
• hide "_" prefixed attachments.

8.2.0

• improve Cucumber HTML reporter to show trace without explicit attachmentsBaseURL.
• introduce BeforeStep / AfterStep hooks (#280, thanks to @the3dsandwich).

8.1.0

• add "Fix with AI" feature
• support attachments via testInfo.attachments.push()
• update all dependencies

8.0.1

• improve --verbose cli output (#197)
• fix default world in Playwright-style steps (#255)

8.0.0

• support tags from path (#217)
• support scoped step definitions by tags (#205)
• new config option missingSteps to setup different behavior when step definitions are missing (#158)
• new config option matchKeywords to enable keyword matching when searching for step definitions (#221)
• add name and tags options to BeforeAll / AfterAll hooks (#219)
• add hooks aliases BeforeWorker, AfterWorker, BeforeScenario, AfterScenario (#219)
• make config option quote default to "single" to have less escapes in the generated files
• config option featuresRoot serves as a default directory for both features and steps, if these options are not explicitly defined
• feature: provide full localized step titles to Playwright HTML reporter (#229, #122)
• show background title in Playwright HTML reporter (#122)
• use Examples: block name as a template for examples test titles
• preserve arg types in call-step-from-step functions (#243)
• handle buffer in attachments (#250)
• increase minimal Playwright version to 1.41

7.5.0

• support external attachments in Cucumber HTML reporter (#182)
• support trace-viewer in Cucumber HTML reporter (#182)
• hide BDD fixtures from Playwright HTML report (#122)

7.4.2

• fix decorator typings for TypeScript consumers with module = commonjs (#222)

7.4.0

• support skipAttachments option in html and message reporters (related to #182)
• revert # subpath imports to relative paths: consumers with (module = commonjs) + (skipLibCheck = false) can't compile the project (#218)

7.3.0

• fix: skipped scenarios break cucumber reports (#143)
• chore: update @cucumber/html-formatter (#213)
• chore: use import subpath from package.json for internal imports
• chore: update dependencies

7.2.2

• fix: provide empty world for Playwright-style steps (#208)
• fix: improve CLI output (#206)

7.2.1

• fix: show snippets even if there are no step definitions found, (#201)
• fix: unexpected Exit Code with cucumberReporter When Setup Fails, (#200)
• chore: set module node16 in tsconfig, remove typesVersions and add types tests

7.1.2

• fix: check exported test variable for manual importTestFrom, (#196)

7.1.1

• fix: improve error messages when guessing importTestFrom, (#196)
• fix: bddgen env throws if there is no @cucumber/cucumber

7.1.0

• fix: access to $tags fixture in non-bdd project, (#189)
• fix: make @retries:0 special tag work, (#187)

7.0.1

• improvement: dropped dependency on chalk and supports-color.

7.0.0

• improvement: remove dependency on Cucumber runner, see all the details in migration guide, (#136)
• improvement: support custom parameter types in decorator steps, (#112)
• improvement: manual importTestFrom option is replaced with automatic detection and most likely can be removed from BDD configuration, (#46)
• improvement: introduce new function defineBddProject() that makes it easier to configure BDD for Playwright projects, (#169)
• chore: set minimal Playwright version to 1.35
• chore: set minimal Node.js version to 18

6.6.0

• bugfix: enable run of non-bdd projects, (#166)

6.5.2

• bugfix: createBdd returns Cucumber-Style Typing when using Playwright-Style, (#163)

6.5.1

• chore: improve esm example, (#164)
• bug: Cucumber reporter accesses non-existent file (#161)

6.5.0

• feature: added new cucumber-style approach

6.4.0

• refactor: apply @timeout and @slow in runtime
• bug: fix cucumber reporters on Win

6.3.1

• feature: support _ in @timeout tag
• fix: support Playwright 1.44 and Cucumber 10.6
• fix: Cucumber reporter doesn't work for non BDD projects (#143)

6.3.0

• improvement: set scenario timeout via test.setTimeout instead of anonymous describe (#139)
• feature: add @slow special tag (#138)
• improvement: relax rules for guessing fixtures in decorator steps, introduce new config option statefulPoms for more strict checks (#102)

6.2.0

• feature: add --version cli flag (#134)
• feature: show step locations in unused export and in duplicate steps error (#113)
• feature: add $step fixture (#133)
• feature: add experimental support of steps option (related to #94)

6.1.1

• fix: support stacktrace for Cucumber 10.4

6.1.0

• feature: add new special tags (#123, #126)
• feature: support new Playwright tags (#98)
• feature: add option --unused-steps to bddgen export (#113)
• feature: show stdout / stderr in Cucumber reports (#116)
• feature: call step from step (#110)
• bug: getting testInfo._runAsStep is not a function after updating to Canary playwright (#119)

6.0.3

• fix timeouts in Cucumber reporters, #107

6.0.2

• fix spec generation for feature file with background without scenarios, #104

6.0.1

• fix Cucumber reporters for non-default language

6.0.0

• support Cucumber reporters 🎉, #9
• update minimal Playwright version to 1.34
• refactor docs navigation, add sidebar groups
• improve docs per users' feedback, #90, #93
• make imports in the generated files use / on win, #91

5.8.0

• support Playwright 1.42, #96

5.7.1

• support Cucumber 10.2

5.7.0

• support Cucumber 10.1, #80

5.6.0

• support component tests, #57
• generate skipped tests with empty body, #73
• allow outline scenario name to be used as an examples template, #67
• fix empty step locations for esm
• fix duplicate steps error message, #74

5.5.0

• add support for hooks, #15
• add support for custom fixtures in cucumber-style steps
• enrich html-report with keywords, #69
• fix snippets on win for cucumber@10, #71

5.4.0

• i18n: Generate scenario outlines correctly #60.
• Check for duplicate fixture names #52
• Fix flushing logs for several projects #59
• Support Playwright 1.39.
• Docs: add search.

5.3.0

• Add support for Playwright 1.38.
• Fix output dir clear on Windows #49).
• Support feature level @fixture: tags #52).

5.2.0

• possibly breaking: Introduce featuresRoot option to have more control of generated files structure #44.

  This fix actually reverts simplification of outputDir by common parent (added in v5, see #40).

  ❤️ I need to admit that automatic simplification of outputDir structure was not the right choice. Playwright heavily relies on tests structure for storing screenshots and we should keep it as stable as possible. I don't like such reverting but better to do it now than later. Introduced featuresRoot allows to strictly control output structure in the same way as TypeScript controls it with rootDir.

  If you use screenshots/snapshots you may need to re-save them to new paths after upgrading.

• Add CLI command bddgen export.

• New documentation website.

• Suppress publishQuiet deprecation warning for Cucumber v9.4+, see #47

5.1.1

• Hotfix for output directory structure with tags filter, see comment

5.1.0

• Add --tags option to filter scenarios by tags expression #36.
• Add bddgen env command to display environment info.

5.0.1

There are several breaking changes in this release. Please check carefully after upgrade.

• breaking: Optimize world initialization, rename World -> BddWorld, WorldOptions -> BddWorldOptions. If you use these classes you may need to rename it as well
• breaking: Resolve paths relative to Playwright config file, not to process.cwd(). If you use custom Playwright config file you may need to update paths in it
• breaking: Simplify generated directories structure #40. If you use snapshots you may need to re-save them in new paths
• Improve support for several calls of defineBddConfig() #39
• Add config option quotes = 'single' | 'double' | 'backtick' to control quotes style in generated tests #34

4.0.0

• Fix running several Playwright projects with shared steps #32
• Support decorators for defining steps #35 (set minimal Playwright version to 1.33)

3.3.0

• Fix getting location from stacktrace, #31
• Use built-in Playwright's loader for TS instead of ts-node, fixes #27

3.2.1

• Improve snippets

3.2.0

• Customize test titles for scenario outline #29
• Generate snippets for undefined steps #17

3.1.0

• Support Cucumber tags #8

3.0.2

• Fix slash in the generated import statement on windows #26
• Fix docs for custom fixtures #25
• Fix --ui mode #24
• Support --verbose CLI flag

3.0.1

Version v3 has several major updates based on the feedback.

• Added support of custom fixtures and playwright-style functions for step definitions #11
• Use single config file: embed Cucumber config into Playwright config #4
• Nice reporting: wrap each cucumber step in test.step #22
• Supported screenshots / snapshots persistence between test runs #23

2.2.0

• Run only one scenario / skip scenario #14
• Support "Scenario Template" keyword #20

2.1.0

• Support Gherkin i18n #13

2.0.0

• Support "Rule" keyword #7
• Generate test files close to Gherkin document structure #10

1.3.0

• Print parsing errors to the console while generating #2

1.2.0

• Initial public release