• Stars
    star
    5,053
  • Rank 8,238 (Top 0.2 %)
  • Language
    TypeScript
  • License
    MIT License
  • Created over 13 years ago
  • Updated 20 days ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Cucumber for JavaScript


Cucumber

Automated tests in plain language, for Node.js

#StandWithUkraine npm build coverage backers sponsors pull requests issues

Cucumber is a tool for running automated tests written in plain language. Because they're written in plain language, they can be read by anyone on your team. Because they can be read by anyone, you can use them to help improve communication, collaboration and trust on your team.

This is the JavaScript implementation of Cucumber. It runs on maintained versions of Node.js. You can quickly try it via CodeSandbox, or read on to get started locally in a couple of minutes.

Looking to contribute? Read our code of conduct first, then check the contributing guide to get up and running.

Install

Cucumber is available on npm:

$ npm install @cucumber/cucumber

Get Started

Let's take this example of something to test:

First, write your main code in src/index.js:

class Greeter {
  sayHello() {
    return 'hello'
  }
}

module.exports = {
  Greeter
}

Then, write your feature in features/greeting.feature:

Feature: Greeting

  Scenario: Say hello
    When the greeter says hello
    Then I should have heard "hello"

Next, implement your steps in features/support/steps.js:

const assert = require('assert')
const { When, Then } = require('@cucumber/cucumber')
const { Greeter } = require('../../src')

When('the greeter says hello', function () {
  this.whatIHeard = new Greeter().sayHello()
});

Then('I should have heard {string}', function (expectedResponse) {
  assert.equal(this.whatIHeard, expectedResponse)
});

Finally, run Cucumber:

$ npx cucumber-js

And see the output:

Terminal output showing a successful test run with 1 scenario and 2 steps, all passing

If you learn best by example, we have a repo with several example projects, that might help you get going.

Documentation

The following documentation is for main, which might contain some unreleased features. See documentation for older versions if you need it.

Support

Support is available from the community if you need it.

More Repositories

1

cucumber-ruby

Cucumber for Ruby. It's amazing!
Ruby
5,178
star
2

common

A home for issues that are common to multiple cucumber repositories
3,363
star
3

cucumber-jvm

Cucumber for the JVM
Java
2,702
star
4

godog

Cucumber for golang
Go
2,307
star
5

cucumber-rails

Rails Generators for Cucumber with special support for Capybara and DatabaseCleaner
Ruby
1,021
star
6

aruba

Test command-line applications with Cucumber-Ruby, RSpec or Minitest.
Ruby
948
star
7

cucumber-java-skeleton

This is the simplest possible setup for Cucumber-JVM using Java.
Java
461
star
8

cucumber-cpp

Support for writing Cucumber step definitions in C++
C++
308
star
9

cucumber-eclipse

Eclipse plugin for Cucumber
Java
192
star
10

gherkin

A parser and compiler for the Gherkin language.
C
182
star
11

cucumber-expressions

Human friendly alternative to Regular Expressions
Java
155
star
12

docs

Cucumber user documentation
CSS
151
star
13

cucumber-android

Android support for Cucumber-JVM
Kotlin
135
star
14

cucumber-electron

Run cucumber.js in electron
JavaScript
118
star
15

gherkin-go

[READ-ONLY] Gherkin for Go - subtree of https://github.com/cucumber/gherkin -- moved to https://github.com/cucumber/gherkin
Go
84
star
16

gherkin-javascript

[READ-ONLY] Gherkin for JavaScript - subtree of monorepo https://github.com/cucumber/cucumber -- moved to https://github.com/cucumber/gherkin
TypeScript
79
star
17

gherkin-python

[READ-ONLY] Gherkin for Python - subtree of monorepo https://github.com/cucumber/cucumber -- moved to https://github.com/cucumber/gherkin
Python
76
star
18

vscode

Official Visual Studio Code Extension for Cucumber
TypeScript
66
star
19

screenplay.js

Library to ease implementation of the Screenplay pattern with CucumberJS
TypeScript
56
star
20

gherkin-java

[READ-ONLY] Gherkin for Java - subtree of monorepo https://github.com/cucumber/cucumber -- moved to https://github.com/cucumber/gherkin
Java
49
star
21

cucumber-jvm-scala

Cucumber Scala
Scala
48
star
22

gherkin-dotnet

[READ-ONLY] Gherkin for Dotnet - subtree of monorepo https://github.com/cucumber/cucumber Gherkin parser/compiler for .NET
C#
46
star
23

language-server

Cucumber Language Server
TypeScript
36
star
24

cucumber-ruby-core

Core library for the Ruby flavour of Cucumber
Ruby
35
star
25

react-components

React components for Cucumber
TypeScript
34
star
26

cucumber-lua

A cucumber wire protocol implementation for Lua step definitions
Lua
29
star
27

cucumber.ml

Cucumber for OCaml
OCaml
27
star
28

cucumber-js-examples

Examples of using Cucumber-JS
Makefile
25
star
29

blockly

Gherkin Editor based on Blockly
TypeScript
24
star
30

cucumber-jvm-groovy

Cucumber Groovy
Java
23
star
31

microdata

Extract WHATWG microdata from a DOM
TypeScript
22
star
32

json-formatter

Provides a language-agnostic command-line tool to convert cucumber messages into a JSON document.
Go
21
star
33

messages

A message protocol for representing results and other information from Cucumber
C#
19
star
34

language-service

Cucumber Language Service
TypeScript
18
star
35

cucumber-js-pretty-formatter

Cucumber.js pretty formatter
TypeScript
17
star
36

monaco

Configure Monaco editor to use cucumber-language-service
TypeScript
16
star
37

html-formatter

HTML formatter for reporting Cucumber results
Java
14
star
38

gherkin-utils

API for working with Gherkin documents
TypeScript
12
star
39

ci-environment

Detect CI Environment from environment variables
Java
10
star
40

gherkin-c

[READ-ONLY] Gherkin for C - subtree of monorepo https://github.com/cucumber/cucumber -- moved to https://github.com/cucumber/gherkin
C
10
star
41

tag-expressions

Cucumber tag expression parser
Python
9
star
42

screenplay.js.examples

Examples using @cucumber/screenplay
TypeScript
7
star
43

cucumber-eclipse-update-site-snapshot

Cucumber Eclipse Update Site Snapshots
CSS
7
star
44

gherkin-objective-c

[READ-ONLY] Gherkin for Objective C - subtree of monorepo https://github.com/cucumber/cucumber -- moved to https://github.com/cucumber/gherkin
Objective-C
7
star
45

gherkin-ruby

[READ-ONLY] Gherkin for Ruby - subtree of monorepo https://github.com/cucumber/cucumber -- moved to https://github.com/cucumber/gherkin
Ruby
7
star
46

cucumber-ruby-wire

Wire protocol plugin for Cucumber
Gherkin
7
star
47

cucumber-json-converter

Parse Cucumber JSON from most Cucumber implementations and versions
TypeScript
6
star
48

polyglot-release

Make polyglot releases with a single command
Shell
5
star
49

todo-react-typescript-subsecond

Tiny Todo app in React and TypeScript demonstrating sub-second test feedback
TypeScript
4
star
50

action-retire-inactive-contributors

Retire inactive contributors from one team to another
TypeScript
4
star
51

cucumber-json-schema

JSON Schemas for Cucumber JSON output
JavaScript
4
star
52

messages-go

[READ ONLY] Cucumber Messages for Go - subtree of monorepo https://github.com/cucumber/messages -- moved to https://github.com/cucumber/messages
Go
3
star
53

gherkin-streams

Stream utilities to read Gherkin parser output.
TypeScript
3
star
54

try-cucumber-expressions

Try Cucumber Expressions in your browser
TypeScript
3
star
55

cucumber-eclipse-update-site

Cucumber Eclipse Update Site
3
star
56

github-settings

Pulumi scripts to automatically configure our GitHub org/repo settings
TypeScript
2
star
57

gherkin-perl

[READ-ONLY] Gherkin for Perl - subtree of monorepo https://github.com/cucumber/cucumber -- moved to https://github.com/cucumber/gherkin
Perl
2
star
58

gherkin-php

[READ ONLY] Cucumber Gherkin for PHP - subtree of https://github.com/cucumber/gherkin
PHP
2
star
59

junit-xml-formatter

JUnit XML formatter for reporting Cucumber results
Java
2
star
60

oselvar-github-metrics

Oselvar GitHub Metrics for the Cucumber Organisation
Shell
2
star
61

build

Docker image used to build the Cucumber Project
Shell
2
star
62

fake-cucumber

Tool to generate test data for cucumber
TypeScript
2
star
63

messages-javascript

[READ ONLY] Cucumber Messages for JavaScript (Protocol Buffers) - subtree of monorepo https://github.com/cucumber/cucumber -- moved to https://github.com/cucumber/messages
TypeScript
2
star
64

commitbit

Microservice that hands out commit bit to everyone who gets a pull request merged
JavaScript
2
star
65

query

A query API for https://github.com/cucumber/messages
Java
2
star
66

aruba-getting-started

Getting started with aruba
Ruby
2
star
67

action-publish-cpan

GitHub Action to publish a Perl module to CPAN
Perl
1
star
68

community-calendar

Public calendar for community calls and events
1
star
69

action-changelog

GitHub Action for changelog tool
Shell
1
star
70

release-announcement-banner

For blog posts where we announce a new version of a Cucumber tool
JavaScript
1
star
71

split-java

A Cucumber plugin to toggle Split features from Cucumber scenarios
Java
1
star
72

cucumber-js-package-upgrade

package to point users to the new @cucumber/cucumber
JavaScript
1
star
73

messages-java

[READ ONLY] Cucumber Messages for Java (Protocol Buffers) - subtree of monorepo https://github.com/cucumber/cucumber
Java
1
star
74

action-publish-subrepo-test-monorepo-a-subfolder

target for tests for https://github.com/cucumber/action-publish-subrepo
1
star
75

cucumber-parent

Parent `pom.xml` for all Cucumber Java modules
1
star
76

action-publish-rubygem

GitHub Action to publish a Ruby Gem
Ruby
1
star
77

compatibility-kit

Platform-agnostic set of acceptance tests for validating cucumber implementations
TypeScript
1
star
78

action-publish-subrepo-test-monorepo

Test repo for testing the action-publish-subrepo GitHub Action
1
star
79

messages-ruby

[READ ONLY] Cucumber Messages for Ruby (Protocol Buffers) - subtree of monorepo https://github.com/cucumber/cucumber -- moved to https://github.com/cucumber/messages
Ruby
1
star
80

renovate-config

Shareable Config Presets for Renovate in the Cucumber org
1
star
81

action-publish-mvn

GitHub Action to publish Maven artefacts
Java
1
star
82

message-streams

Stream utilities to read and write Cucumber Message objects to/from streams.
TypeScript
1
star
83

action-publish-npm

GitHub Action to publish an NPM module
1
star
84

messages-dotnet

[READ ONLY] Cucumber Messages for .NET (Protocol Buffers) - subtree of monorepo https://github.com/cucumber/cucumber -- moved to https://github.com/cucumber/messages
Makefile
1
star
85

.github

πŸ‘©β€βš•οΈ Default community health files for the Cucumber organisation on GitHub.
Shell
1
star