NSWI142: Web Applications

Demonstration: PHPUnit

Simple test ...

The test file must contain a class matching the file name. A class method which name starts with "test" defines a test.

      <?php

      use PHPUnit\Framework\TestCase;

      final class SimpleTest extends TestCase
      {
          public function testAddition(): void
          {
              $this->assertSame(2, 1 + 1);
          }
      }
    

Search and run all "*Test.php" files in tests directory (and subdirecories):

      phpunit ./tests
    

Demonstration: node:test

The node:test is part of NodeJS modules. While usually not the first choice, it can get the job done.

Simple test ...

Content of simple.test.js file:

      import assert from "node:assert";
      import test from "node:test";

      test("Test addition.", () => {
        const actual = 1 + 1;
        const expected = 2;
        assert.strictEqual(actual, expected);
      });
    

Search for test files in this and subdirectories (e.g. test-feature.js, feature.test.js, ...):

      node --test
    

We can also use --watch to watch for file changes.

JavaScript modules

In order to write a test for JS functionality, we need to be able to export and import classes, functions, and variables. In the following example, we create a simple.js file that exports function add.

Content of simple.js file:

      function add(left, right) {
        return left + right;
      }
      // module.exports = { add };
      export { add };
    

Content of simple.test.js file:

      import assert from "node:assert";
      import test from "node:test";

      import { add } from "./simple.js";

      test("Test addition.", () => {
        const actual = add(1, 1);
        const expected = 2;
        assert.strictEqual(actual, expected);
      });
    

Grouping tests together

We can groups tests into suites. In the following example, "suite" can be replaced with "describe" and "test" can be replaced with "it".

      import assert from "node:assert";
      import { suite, test } from "node:test";

      import { add } from "./simple.js";

      suite("add", () => {

        test("Add zeros.", () => {
          const actual = add(0, 0);
          assert.strictEqual(actual, 0);
        });

        test("Add negative.", () => {
          const actual = add(1, -1);
          assert.strictEqual(actual, 0);
        });

      });