Testing

    will search in ./* and ./**/* recursively, for test files:

    • named test.{ts, tsx, js, mjs, jsx},
    • or ending with .test.{ts, tsx, js, mjs, jsx},
    • or ending with _test.{ts, tsx, js, mjs, jsx}

    To define a test you need to call Deno.test with a name and function to be tested. There are two styles you can use.

    Assertions

    There are some useful assertion utilities at to make testing easier:

    1. import {
    2.   assertArrayIncludes,
    3.   assertEquals,
    4. } from "https://deno.land/std@$STD_VERSION/testing/asserts.ts";
    6. Deno.test("hello world", () => {
    7.   const x = 1 + 2;
    8.   assertEquals(x, 3);
    9.   assertArrayIncludes([1, 2, 3, 4, 5, 6], [3], "Expected 3 to be in the array");
    10. });

    You can also test asynchronous code by passing a test function that returns a promise. For this you can use the async keyword when defining a function:

    1. import { delay } from "https://deno.land/std@$STD_VERSION/async/delay.ts";
    3.   const x = 1 + 2;
    5.   // await some async task
    6.   await delay(100);
    8.   if (x !== 3) {
    9.     throw Error("x should be equal to 3");
    10.   }
    11. });

    Certain actions in Deno create resources in the resource table (learn more here). These resources should be closed after you are done using them.

    For each test definition, the test runner checks that all resources created in this test have been closed. This is to prevent resource ‘leaks’. This is enabled by default for all tests, but can be disabled by setting the sanitizeResources boolean to false in the test definition.

    The same is true for async operation like interacting with the filesystem. The test runner checks that each operation you start in the test is completed before the end of the test. This is enabled by default for all tests, but can be disabled by setting the sanitizeOps boolean to false in the test definition.

    1. Deno.test({
    3.   fn() {
    4.     Deno.open("hello.txt");
    5.   },
    6.   sanitizeResources: false,
    7.   sanitizeOps: false,
    8. });

    There’s also the exit sanitizer which ensures that tested code doesn’t call Deno.exit() signaling a false test success.

    To run the test, call deno test with the file that contains your test function. You can also omit the file name, in which case all tests in the current directory (recursively) that match the glob {*_,*.,}test.{js,mjs,ts,jsx,tsx} will be run. If you pass a directory, all files in the directory that match this glob will be run.

    1. # Run all tests in the current directory and all sub-directories
    2. deno test
    4. # Run all tests in the util directory
    5. deno test util/
    7. # Run just my_test.ts
    8. deno test my_test.ts

    deno test uses the same permission model as deno run and therefore will require, for example, --allow-write to write to the file system during testing.

    To see all runtime options with deno test, you can reference the command line help:

    1. deno help test

    Filtering

    There are a number of options to filter the tests you are running.

    Tests can be run individually or in groups using the command line --filter option.

    The filter flags accept a string or a pattern as value.

    Assuming the following tests:

    1. Deno.test({ name: "my-test", fn: myTest });
    2. Deno.test({ name: "test-1", fn: test1 });

    This command will run all of these tests because they all contain the word “test”.

    1. deno test --filter "/test-*\d/" tests/

    To let Deno know that you want to use a pattern, wrap your filter with forward-slashes like the JavaScript syntactic sugar for a REGEX.

    Within the tests themselves, you have two options for filtering.

    Filtering out (Ignoring these tests)

    Sometimes you want to ignore tests based on some sort of condition (for example you only want a test to run on Windows). For this you can use the ignore boolean in the test definition. If it is set to true the test will be skipped.

    1. Deno.test({
    2.   name: "do macOS feature",
    3.   ignore: Deno.build.os !== "darwin",
    4.   fn() {
    6.   },
    7. });

    Filtering in (Only run these tests)

    Sometimes you may be in the middle of a problem within a large test class and you would like to focus on just that test and ignore the rest for now. For this you can use the only option to tell the test framework to only run tests with this set to true. Multiple tests can set this option. While the test run will report on the success or failure of each test, the overall test run will always fail if any test is flagged with only, as this is a temporary measure only which disables nearly all of your tests.

    1. Deno.test({
    2.   name: "Focus on this test only",
    3.   only: true,
    4.   fn() {
    5.     testComplicatedStuff();
    6.   },
    7. });

    If you have a long running test suite and wish for it to stop on the first failure, you can specify the --fail-fast flag when running the suite.

    Test coverage

    Deno will collect test coverage into a directory for your code if you specify the --coverage flag when starting deno test.

    This coverage information is acquired directly from the JavaScript engine (V8) which is very accurate.

    This can then be further processed from the internal format into well known formats by the deno coverage tool.

    1. # Go into your project's working directory
    2. git clone https://github.com/oakserver/oak && cd oak
    4. # Collect your coverage profile with deno test --coverage=<output_directory>
    5. deno test --coverage=cov_profile
    7. # From this you can get a pretty printed diff of uncovered lines
    8. deno coverage cov_profile
    10. # Or generate an lcov report
    11. deno coverage cov_profile --lcov > cov_profile.lcov
    13. # Which can then be further processed by tools like genhtml

    These filters can be overridden using the and --include flags. A source file’s url must match both regular expressions for it to be a part of the report.