Build your own test framework

About the author

Changelog

Preface

How to use this book

1. In a workshop setting
2. Tools you’ll need
3. Skills you’ll need
4. Feedback
5. Please share with your friends and followers

Introduction

1. An overview of this book
2. What is an automated unit test framework?
3. What will we build in this book?
4. We’re building a spike
5. Let’s get started: The sample app
6. Understanding the benefits of a test framework
7. Building the core of a test framework

1. Creating an NPM package of my very own

1. Creating the project
2. Customizing package.json
3. Creating the executable file
4. Creating the runner
5. Linking the sample application to the library project
6. Update the test runner to run our existing script
7. Verify that it works by breaking a test
8. Catch exceptions from the await call
9. Committing to Git
10. Summary

2. Building it to define a test

1. Adding scoped context
2. Handling exceptions
3. Printing test descriptions
4. Support CI with correct exit codes
5. Summarizing a test run
6. Summary

3. Grouping tests with describe

1. A starting point for describe
2. Rethinking test output
3. Saving test context information
4. Supporting nested describe blocks
5. Summary

4. Promoting conciseness with beforeEach and afterEach

1. Applying beforeEach blocks to our test
2. Updating the sample application
3. Defining afterEach
4. Generalizing beforeEach
5. Generalizing invokeBefores
6. Summary

5. Improving legibility with expect

1. Starting with the toBeDefined matcher
2. Creating an Error subtype
3. Allowing multiple failures per test
4. Making a mess
5. Summary
6. Constructing a usable framework

6. Formatting expectation errors

1. Building stackTraceFormatter
2. Joining up our formatter with the runner
3. Summary

7. Automatically discovering test files

1. Discovering files
2. Running a single file
3. Summary

8. Focusing on tests with it.only and describe.only

1. Parsing describe
2. Adding it
3. Adding beforeEach and afterEach
4. Implementing the run phase
5. Updating the runner
6. Moving out expect
7. Adding the focus functions
8. Filtering tests
9. Summary

9. Supporting asynchronous tests

1. Waiting for Promise completion
2. Testing it out
3. Catching exceptions
4. Timing out tests after a period of time with it.timesOutAfter
5. Testing it out
6. Summary

10. Reporting

1. Adding an event dispatcher
2. Dispatching a begin suite event
3. Dispatching a test finished event
4. Summary
5. Extending for power users

11. Sharing behavior with it.behavesLike

1. Implementing a shared example repository
2. Summary

12. Tagging tests

1. Thinking through design options
2. Adding tags on describe
3. Adding tags on it
4. Filtering to only tagged tests
5. Adding tags to the sample application
6. Summary

13. Skipping tests

1. Adding the .skip extensions
2. Testing it out
3. Supporting no-body describe and it
4. Summary

14. Randomizing tests

1. Adding the flag
2. Summary
3. Future chapters

15. Supporting preprocessors

16. Watch mode

1. Where to go from here
2. Give feedback
3. This was a spike
4. Ideas for refactoring
5. Ideas for extensions
6. Contribute to concise-test