Cliffy

Options

Name

The name of the test.

meta

The meta option is required and needs to be set to import.meta. This is required for executing the snapshot tests.

fn

Test function that executes your test code. A snapshot is taken of the stdout and stderr outputs of this function and stored in the snapshot file.

steps

With the steps option you can add multiple steps to the test function. The snapshotTest method then calls the test function once for each step within a separate test step by calling t.step() from the test context. Each step can have separate options for stdin and args. (see Test steps)

denoArgs

Arguments passed to the deno test command when executing the snapshot tests. --allow-env=SNAPSHOT_TEST_NAME is passed by default.

dir

Snapshot output directory. Snapshot files will be written to this directory. This can be relative to the test directory or an absolute path.

If both dir and path are specified, the dir option will be ignored and the path option will be handled as normal.

path

Snapshot output path. The snapshot will be written to this file. This can be a path relative to the test directory or an absolute path.

If both dir and path are specified, the dir option will be ignored and the path option will be handled as normal.

osSuffix

Operating system snapshot suffix. This is useful when your test produces different output on different operating systems. osSuffix is an array of typeof Deno.build.os.

colors

Enable/disable colors. Default is true.

timeout

Timeout in milliseconds to wait until the input stream data is buffered before writing the next data to the stream. This ensures that each user input is rendered as separate line in the snapshot file. If your test gets flaky, try to increase the timeout. The default timeout is 600.

ignore

If truthy the current test step will be ignored.

It is a quick way to skip over a step, but also can be used for conditional logic, like determining if an environment feature is present.

only

If at least one test has only set to true, only run tests that have only set to true and fail the test suite. only?: boolean;