testing-workshop-cypress

A full day testing workshop complete with application, exercise tests and speaker slides for Cypress.io

Requirements ⚙️

• Any computer: Mac, Windows, Linux
• Node 6+
• git

In order to get the code and install dependencies

git clone [email protected]:cypress-io/testing-workshop-cypress.git
cd testing-workshop-cypress
npm install

If necessary, install dependencies inside react-todomvc folder

cd react-todomvc
npm install

Quick check ✅

You can test the installation by starting React TodoMVC in the first terminal window

cd react-todomvc
npm start

and you should see in the terminal

> json-server --static . data.json --middlewares ./node_modules/json-server-reset


  \{^_^}/ hi!

  Loading data.json
  Loading ./node_modules/json-server-reset
  Done

  Resources
  http://localhost:3000/todos

  Home
  http://localhost:3000

Note for Windows users: if npm start throws an error, it is probably due to cd todomvc; ... first command in the npm start script. In this case change the working folder to "todomvc" and run npm start from there.

From the second terminal window you should be able to open Cypress with

$ npm run cy:open

> [email protected] cy:open /git/testing-workshop-cypress
> cypress open

Application 💾

ReactJS + REST server application that we are going to test is in the folder react-todomvc. This application and its full testing is described in this site. The application should run fine without network access.

Slides 🖥

See the presentation at https://gitpitch.com/cypress-io/testing-workshop-cypress with the starting file in PITCHME.md presented using GitPitch. The pitch file includes files from the slides folder. Students should open the presentation slides and follow along. You can also show each section separately by clicking on the "slides" link in the table below. The full presentation includes all these presentations.

Content 🗂

Beginner

	topic	folder	contents	slides
🔗	Introduction, TodoMVC application	todomvc	intro.md	link
🔗	Loading page	00-start	00-start	link
🔗	cypress open vs cypress run	01-basic	01-basic	link
🔗	Adding items test, cypress.json file	02-adding-items	02-adding-items	link
🔗	Selector Playground	03-selector-playground	03-selector-playground	link
🔗	Reset database using cy.request	04-reset-state	04-reset-state	link
🔗	Spy and stub XHR requests, fixtures	05-xhr	05-xhr	link
🔗	Access application code and data	06-app-data-store	06-app-data-store	link

Intermediate

	topic	folder	contents	slides
🔗	Setting up E2E tests on CI	07-ci	07-ci	link
🔗	Setting up Cypress Dashboard	07-ci	08-dashboard	link
🔗	Test reporters	-	09-reporters	link
🔗	Configuration	-	10-configuration	link
🔗	Retry-ability	11-retry-ability	11-retry-ability	link
🔗	Custom commands	12-custom-commands	12-custom-commands	link

Advanced

	topic	folder	contents	slides
🔗	Page Objects vs App Actions	13-app-actions	13-app-actions	link
🔗	Fixtures	14-fixtures	14-fixtures	link
🔗	Debugging	02-adding-items/demo.js	15-debugging	link
🔗	Preprocessors	16-preprocessors	16-preprocessors	link
🔗	Component testing	17-component-testing	17-component-testing	link
🔗	Backend code	18-backend	18-backend	link
🔗	Code coverage	19-code-coverage	19-code-coverage	link
	The end	-	end	link

For speakers 🎙

The content has been curated to run in a 3 hours workshop. Everyone worked or coded for the most part, except for CI and the Cypress Dashboard sections, where the usage was shown via slides and actual sites.

During the workshop, keep the react-todomvc app running in one shell, while each section 01-basic, 02-..., 03-... etc. has its own Cypress and specs subfolders cypress/integration/.... Usually a spec has several tests with placeholder comments. The workshop attendees are expected to make the tests pass using the knowledge from the slides and hints (and Cypress documentation). Note that most folders have a prepared spec.js file and an answer.js file. The answer.js file is ignored by Cypress using a setting in cypress.json.

The only exception is the folder 00-start. This is a folder for students to see how Cypress scaffolds example specs when you open Cypress for the very first time. In this folder students should execute...

cd 00-start
npm run cy:open

...and see the list of created example specs.

The slides can be shown directly via the presentation link above. The Markdown files in slides folder also has a little bit of speaker notes.

Every time a new Todo is saved or deleted, it changes file todomvc/data.json. To reset the list back to empty run npm run reset command.

Additional information 🗃

• https://www.cypress.io/
• https://docs.cypress.io/
• https://docs.cypress.io/api/api/table-of-contents.html