Serenity/JS Workshop

Hello and welcome to Serenity/JS Workshop where you'll learn how to follow the Screenplay Pattern and implement high-quality, full-stack acceptance tests.

Prerequisites

Before the workshop, please make sure you have the following tools installed on your computer:

• Git
• Node.js - you'll need version 12, the latest Long-Term Support (LTS) release
• Java Runtime Environment version 8 or newer
• Chrome web browser
• Visual Studio Code, with following plugins:
  • Code runner
  • NPM
  • ESLint
  • IntelliCode
  • Mocha Test Explorer
  • Run Protractor
  • optional: Code Spell Checker
  • optional: IntelliJ IDEA Keybindings

Once you've installed the above, please make sure they're working as expected by running the following commands in your terminal:

git --version

# expected output:
git version 2.21.0 (Apple Git-122)

node --version

# expected output:
v12.14.1

npm --version

# expected output:
6.13.4

java -version

# expected output:
java version "1.8.0_181"
Java(TM) SE Runtime Environment (build 1.8.0_181-b13)
Java HotSpot(TM) 64-Bit Server VM (build 25.181-b13, mixed mode)

Project setup

To set up the project, please clone this repository to the location of your choice using your computer terminal:

git clone https://github.com/serenity-js/workshop.git

Learn more about cloning and git.

Next, switch to the directory where you've cloned the project and download its runtime dependencies using Node Package Manager (NPM):

cd workshop
npm install

Learn more about npm install.

When the installation is finished, the project will verify your environment and if everything is fine, you should see the below message after npm install completes:

    Looks like you're ready to go! Congrats :-)

Running tests

Before running the tests, start the demo app by executing the following command using your computer terminal:

npm start

Next, in a second terminal, execute all tests for all the exercises:

npm test

Using Visual Studio Code

Visual Studio Code keyboard shortcuts:

• Windows
• Mac
• Linux

License

Serenity/JS Workshop by Jan Molak is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

For commercial use, please contact the author.