This project contains materials for my TDD workshop, "Building Quality JavaScript With Test-Driven Development."

The materials are divided into 6 modules. Start by reading the Module 0: Setup instructions.

If you are unable to complete Module 0: Setup, please raise your hand (if in-person), or create an issue in this repository (if not in-person).

Each of the main modules (1-5) will follow the same life cycle:

1. The instructor will introduce concepts and tools you'll be using for the module.
2. You'll work through the module on your own, or with others around you.
3. We'll recap our findings as a group.

Within each module, a pointer finger symbol (👉) indicates instructions which require you to take specific action.

If you have trouble running any of the commands in the modules, see the Troubleshooting section of this guide.

The code for most modules contains a __solutions folder. If you get stuck writing code for any modules, you can look there for inspiration.

This module will get you set up for the workshop. Start here!

An introduction to Jest's interactive watch mode. This module will get you comfortable with running tests.

An instructor-led demonstration of TDD. You'll experience the red-green-refactor feedback loop.

A small problem that will help get you in the habit of writing tests first.

Module 4 will give you experience with applying TDD to real-life problems.

Real-life problems aren't always easy to test. This submodule will teach you how to isolate things you can't control.

One great place to introduce TDD into your app is business logic. Business logic is generally less dependent on UI, and can be easier to test in isolation. This submodule gives you practice writing business logic with TDD.

Another great place to introduce TDD into a project is by fixing bugs. This submodule will show you how to fix bugs with TDD, giving you confidence to introduce it into your projects.

A more complicated problem to give you more TDD experience. We'll work through it in pairs.

If a command isn't working, use the following checklist to try to identify the problem.

• Did you install Node, NPM, and git? If not, start here.
• Are there any error messages in the command window that identify the problem? Take a closer look - sometimes the error messages are there, but surrounded by noise.
• If you're having trouble with a module that uses the browser, are there any error messages in the JavaScript console? These might help you identify the problem.

If you still can't figure out why things aren't working, raise your hand, or create an issue against this repository.

Notes about how this repository was created are collected here.

Some links that might come in handy during this workshop:

• Jest docs
• List of Jest matchers