9 Getting started with quizzes and exercises

Throughout most chapters, there are quizzes and exercises. These are a paid feature, but a comprehensive preview is available. This chapter explains how to get started with them.

9.1 Quizzes

Installation:

• Download and unzip impatient-js-quiz.zip

Running the quiz app:

• Open impatient-js-quiz/index.html in a web browser
• You’ll see a TOC of all the quizzes.

9.2 Exercises

9.2.1 Installing the exercises

To install the exercises:

• Download and unzip impatient-js-code.zip
• Follow the instructions in README.txt

9.2.2 Running exercises

• Exercises are referred to by path in this book.
  • For example: exercises/quizzes-exercises/first_module_test.mjs
• Within each file:
  • The first line contains the command for running the exercise.
  • The following lines describe what you have to do.

9.3 Unit tests in JavaScript

All exercises in this book are tests that are run via the test framework AVA. This section gives a brief introduction.

9.3.1 A typical test

Typical test code is split into two parts:

• Part 1: the code to be tested.
• Part 2: the tests for the code.

Take, for example, the following two files:

• id.mjs (code to be tested)
• id_test.mjs (tests)

9.3.1.1 Part 1: the code

The code itself resides in id.mjs:

export function id(x) {
  return x;
}

The key thing here is: everything you want to test must be exported. Otherwise, the test code can’t access it.

9.3.1.2 Part 2: the tests

The tests for the code reside in id_test.mjs:

import test from 'ava'; // (A)
import {strict as assert} from 'assert'; // (B)
import {id} from './id.mjs'; // (C)

test('My test', t => { // (D)
  assert.equal(id('abc'), 'abc'); // (E)
});

The core of this test file is line E – an assertion: assert.equal() specifies that the expected result of id('abc') is 'abc'.

As for the other lines:

• Line A: We import the test framework.
• Line B: We import the assertion library. AVA has built-in assertions, but module assert lets us remain compatible with plain Node.js.
• Line C: We import the function to test.
• Line D: We define a test. This is done by calling the function test():
  • First parameter: the name of the test.
  • Second parameter: the test code, which is provided via an arrow function. The parameter t gives us access to AVA’s testing API (assertions etc.).

To run the test, we execute the following in a command line:

npm t demos/quizzes-exercises/id_test.mjs

The t is an abbreviation for test. That is, the long version of this command is:

npm test demos/quizzes-exercises/id_test.mjs

9.3.2 Asynchronous tests in AVA

Writing tests for asynchronous code requires extra work: The test receives its results later and has to signal to AVA that it isn’t finished, yet, when it returns. The following subsections examine three ways of doing so.

9.3.2.1 Asynchronicity via callbacks

If we call test.cb() instead of test(), AVA switches to callback-based asynchronicity. When we are done with our asynchronous work, we have to call t.end():

test.cb('divideCallback', t => {
  divideCallback(8, 4, (error, result) => {
    if (error) {
      t.end(error);
    } else {
      assert.strictEqual(result, 2);
      t.end();
    }
  });
});

9.3.2.2 Asynchronicity via Promises

If a test returns a Promise, AVA switches to Promise-based asynchronicity. A test is considered successful if the Promise is fulfilled and failed if the Promise is rejected.

test('dividePromise 1', t => {
  return dividePromise(8, 4)
  .then(result => {
    assert.strictEqual(result, 2);
  });
});

9.3.2.3 Async functions as test “bodies”

Async functions always return Promises. Therefore, an async function is a convenient way of implementing an asynchronous test. The following code is equivalent to the previous example.

test('dividePromise 2', async t => {
  const result = await dividePromise(8, 4);
  assert.strictEqual(result, 2);
  // No explicit return necessary!
});

You don’t need to explicitly return anything: The implicitly returned undefined is used to fulfill the Promise returned by this async function. And if the test code throws an exception then the async function takes care of rejecting the returned Promise.