Chorus BDD

Free plan LinuxMacSelf-hostedWindows

What Chorus BDD is

Chorus BDD is an open-source Behaviour Driven Development interpreter for testing distributed systems. You write scenarios as Gherkin feature files using Given, When and Then steps. During execution, Chorus connects with processes in the test environment and discovers their step definitions, whether those processes run locally or on remote servers. Client libraries allow Java/JVM and JavaScript components to publish steps, including browser-oriented JavaScript definitions sent through WebSockets. Chorus can run as a Java JUnit suite, a Docker container, or a standalone command-line installation. Its JUnit 4-compatible runner exposes each scenario as a test. Built-in handlers cover process control, SQL statements and Selenium browser interaction. Selenium can use a remote WebDriver or Selenium Grid, although the currently exposed steps open a browser and navigate to a URL. Chorus supports Linux, macOS, Windows and self-hosted deployment. It is free under the MIT license, with local execution, Gherkin support and API access.

Who it suits

Chorus suits teams building distributed systems who want Gherkin scenarios and runtime discovery of steps from Java/JVM or JavaScript components. It also fits projects needing JUnit, Docker or command-line execution.

What it does well

Open-source and free under the MIT license
Discovers steps from local or remote processes
Supports Java/JVM and JavaScript clients
Runs with JUnit, Docker or command line
Works on Linux, macOS and Windows

What to know first

Selenium steps currently cover browser opening and URL navigation
Chorus 3.x requires JDK 8 or later
Full Selenium capabilities are not exposed

Limits

The Selenium handler currently supplies steps to open a browser and navigate to a URL; its full Selenium capabilities are not exposed. Chorus 3.x requires JDK 8 or later, while Chorus 4.0 is built with JDK 17 and keeps Java 8 source and target compatibility.

Getting started

Visit https://www.chorus-bdd.org/
Install Chorus for Linux, macOS, Windows, or self-hosted use
Provide JDK 8 or later for Chorus 3.x, or use the JDK 17-based Chorus 4.0
Write scenarios in Gherkin feature files
Choose JUnit, Docker, or the standalone command-line run
Connect Java/JVM or JavaScript components to publish step definitions

Verdict

Chorus BDD combines Gherkin scenarios with runtime discovery across distributed components. Its multiple execution modes and client libraries support varied test setups, while browser automation remains limited to the listed Selenium steps.

Questions

What does Chorus BDD cost?

Chorus is free and open source, licensed under the MIT license.

Which operating systems are supported?

It supports Linux, macOS, Windows, and self-hosted use.

How are tests written?

Tests use Gherkin feature files with Given, When, Then scenarios.

How can Chorus run?

It can run as a Java JUnit suite, a Docker container, or a standalone command-line installation.

Which languages can publish test steps?

Client libraries support Java/JVM and JavaScript components. The JavaScript client publishes definitions over WebSocket.

What Java version is required?

Chorus 3.x requires JDK 8 or later. Chorus 4.0 is built with JDK 17 while retaining Java 8 source and target compatibility.

Facts from Chorus BDD's own pages

Browser integration: The chorus-js client publishes browser-based JavaScript step definitions to Chorus over a WebSocket connection. · chorus-bdd.org, 8 Oct 2026
Browser testing: The Selenium handler can open and interact with browsers and can be configured to use a remote WebDriver or Selenium Grid. · chorus-bdd.org, 8 Oct 2026
Browser testing limit: The Selenium handler provides steps to open a browser and navigate to a URL, while the full Selenium capabilities are not exposed. · chorus-bdd.org, 8 Oct 2026
Built-in handlers: Built-in handlers support process control, browser interaction through Selenium, and SQL statements. · chorus-bdd.org, 8 Oct 2026
Distributed components: Client libraries let Java/JVM and JavaScript components publish test steps to Chorus. · chorus-bdd.org, 8 Oct 2026
Distributed testing: It can discover and run test steps published by components running locally or on remote servers. · chorus-bdd.org, 8 Oct 2026
Execution options: Chorus can run as a Java JUnit suite, a Docker container, or a standalone command-line install. · chorus-bdd.org, 8 Oct 2026
Java requirements: The site says Chorus 3.x requires JDK 8 or later and describes Chorus 4.0 as built with JDK 17 while maintaining Java 8 source and target compatibility. · chorus-bdd.org, 8 Oct 2026
JavaScript integration: The chorus-js client publishes step definitions to the interpreter over a WebSocket connection. · chorus-bdd.org, 8 Oct 2026
Java test integration: The JUnit integration provides a JUnit 4 compliant runner that exposes each scenario as a test. · chorus-bdd.org, 8 Oct 2026
License: The project describes itself as open source and licensed under the MIT license. · chorus-bdd.org, 8 Oct 2026
Purpose: Chorus is an open-source Behaviour Driven Development test interpreter for distributed systems. · chorus-bdd.org, 8 Oct 2026
Run options: Chorus can run as a Java JUnit suite, in a Docker container, or from the command line as a standalone installable package. · chorus-bdd.org, 8 Oct 2026
Runtime discovery: The interpreter can connect to other processes in a test environment to discover step definitions at runtime. · chorus-bdd.org, 8 Oct 2026
Security: The changelist says version 3.1.2 added support for secure JMX connections using a username and password in the Remoting handler configuration. · chorus-bdd.org, 8 Oct 2026
Selenium scope: The Selenium handler currently provides steps to open a browser and navigate to a URL, while its full capabilities are not exposed. · chorus-bdd.org, 8 Oct 2026
Support: The About page directs users with questions or suggestions to open an issue on GitHub. · chorus-bdd.org, 8 Oct 2026
Supported clients: Chorus provides client libraries for Java/JVM and JavaScript components. · chorus-bdd.org, 8 Oct 2026
Support information: The opened maker pages describe documentation and downloadable run options but do not state a support plan or response time. · chorus-bdd.org, 8 Oct 2026
Test format: Tests are written as feature files in Gherkin’s Given, When, Then format. · chorus-bdd.org, 8 Oct 2026

Where Chorus BDD stands on Freedom251

BDD Testing Tools#6 of 30