Gherkin BDD Runner

About

BDD Runner is a powerful Chrome side panel extension for writing and executing Gherkin BDD scenarios — no server, no CLI, no setup. Test REST APIs, automate browser interactions, and extend your tests with Lua scripting, all from a sleek editor built into your browser.

✨ FEATURES ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📝 Full-Featured Gherkin Editor Write tests in familiar Given / When / Then format with a CodeMirror-powered editor that includes syntax highlighting, auto-indentation, and Tab support. Save and organize multiple feature files with the built-in file manager.

🌐 HTTP / API Testing Execute REST API requests directly from your scenarios — GET, POST, PUT, DELETE, PATCH. Set headers, query parameters, and request bodies. Validate responses with powerful assertions: exact match, contains, not-equal, and schema validation with type markers like #number and #string. Chain requests by capturing response values into variables with def.

🖥️ Browser Automation Control any web page using Chrome DevTools Protocol. Click, fill inputs, select dropdowns, check/uncheck boxes, press keyboard keys, wait for elements, scroll, and take screenshots — all from Gherkin steps. Use standard CSS selectors or accessibility tree selectors (e.g., button "Login", textbox "Username") for resilient, readable tests.

🔧 Lua Scripting Engine Go beyond built-in steps with inline Lua code. Parse JSON responses, run complex assertions, and capture computed values into variables. Create reusable custom step definitions with the Lua Script Manager — write a pattern once, use it across all your scenarios.

📊 Real-Time Results Panel See test results as they execute, organized by feature and scenario with clear pass/fail indicators, timing, print output, and inline screenshots. Instantly identify what passed and what failed.

📋 Scenarios Panel Browse all scenarios across your saved feature files in one view. Select individual scenarios with checkboxes and run them on demand — no need to switch between files.

💾 Persistent Storage Feature files and Lua scripts are saved to Chrome's built-in storage. Your tests are always there when you need them, across browser restarts.


🚀 HOW IT WORKS ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Click the BDD Runner icon to open the side panel
Write or paste a Gherkin feature in the Editor tab
Hit ▶ Run — results appear instantly in the Results tab
Save your features, organize them, and run them anytime


💡 EXAMPLE ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Feature: User API Scenario: Get a user Given url 'https://jsonplaceholder.typicode.com/users/1' When method GET Then status 200 And match response.name == 'Leanne Graham'

Feature: SauceDemo Login Scenario: Login with accessibility selectors Given browser open 'https://www.saucedemo.com' And browser fill 'textbox "Username"' with 'standard_user' And browser fill 'textbox "Password"' with 'secret_sauce' And browser click 'button "Login"' Then browser text 'heading "Products"' == 'Products' And browser screenshot


🔒 PERMISSIONS ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Side Panel — to display the editor and results UI • Storage — to persist your feature files and Lua scripts • Debugger — to control browser tabs for automation steps • Host Permissions (all URLs) — to make HTTP requests to any API endpoint and automate any web page