deno test

deno test [OPTIONS] [files]... [-- [SCRIPT_ARG]...]

deno test src/fetch_test.ts src/signal_test.ts

deno test src/

Type checking options Jump to heading#

--check Jump to heading#

Set type-checking behavior. This subcommand type-checks local modules by default, so adding --check is redundant If the value of "all" is supplied, remote modules will be included. Alternatively, the 'deno check' subcommand can be used.

--no-check Jump to heading#

Skip type-checking. If the value of "remote" is supplied, diagnostic errors from remote modules will be ignored.

Dependency management options Jump to heading#

--cached-only Jump to heading#

Require that remote dependencies are already cached.

--frozen Jump to heading#

Error out if lockfile is out of date.

--import-map Jump to heading#

Load import map file from local file or remote URL.

--lock Jump to heading#

Check the specified lock file. (If value is not provided, defaults to "./deno.lock").

--no-lock Jump to heading#

Disable auto discovery of the lock file.

--no-npm Jump to heading#

Do not resolve npm modules.

--no-remote Jump to heading#

Do not resolve remote modules.

--node-modules-dir Jump to heading#

Sets the node modules management mode for npm packages.

--reload Jump to heading#

Short flag: -r

Reload source code cache (recompile TypeScript) no value Reload everything jsr:@std/http/file-server,jsr:@std/assert/assert-equals Reloads specific modules npm: Reload all npm modules npm:chalk Reload specific npm module.

--vendor Jump to heading#

Toggles local vendor folder usage for remote modules and a node_modules folder for npm packages.

Options Jump to heading#

--allow-scripts Jump to heading#

Allow running npm lifecycle scripts for the given packages Note: Scripts will only be executed when using a node_modules directory (--node-modules-dir).

--cert Jump to heading#

Load certificate authority from PEM encoded file.

--config Jump to heading#

Short flag: -c

Configure different aspects of deno including TypeScript, linting, and code formatting Typically the configuration file will be called deno.json or deno.jsonc and automatically detected; in that case this flag is not necessary.

--env-file Jump to heading#

Load environment variables from local file Only the first environment variable with a given key is used. Existing process environment variables are not overwritten.

--ext Jump to heading#

Set content type of the supplied file.

--hide-stacktraces Jump to heading#

Hide stack traces for errors in failure test results.

--ignore Jump to heading#

Ignore files.

--location Jump to heading#

Value of globalThis.location used by some web APIs.

--no-config Jump to heading#

Disable automatic loading of the configuration file.

--parallel Jump to heading#

Run test modules in parallel. Parallelism defaults to the number of available CPUs or the value of the DENO_JOBS environment variable.

--seed Jump to heading#

Set the random number generator seed.

--v8-flags Jump to heading#

To see a list of all available flags use --v8-flags=--help Flags can also be set via the DENO_V8_FLAGS environment variable. Any flags set with this flag are appended after the DENO_V8_FLAGS environment variable.

Debugging options Jump to heading#

--inspect Jump to heading#

Activate inspector on host:port [default: 127.0.0.1:9229]

--inspect-brk Jump to heading#

Activate inspector on host:port, wait for debugger to connect and break at the start of user script.

--inspect-wait Jump to heading#

Activate inspector on host:port and wait for debugger to connect before running user code.

Testing options Jump to heading#

--clean Jump to heading#

Empty the temporary coverage profile data directory before running tests. Note: running multiple deno test --clean`` calls in series or parallel for the same coverage directory may cause race conditions.

--coverage Jump to heading#

Collect coverage profile data into DIR. If DIR is not specified, it uses 'coverage/'.

--doc Jump to heading#

Evaluate code blocks in JSDoc and Markdown.

--fail-fast Jump to heading#

Stop after N errors. Defaults to stopping after first failure.

--filter Jump to heading#

Run tests with this string or regexp pattern in the test name.

--junit-path Jump to heading#

Write a JUnit XML test report to PATH. Use '-' to write to stdout which is the default when PATH is not provided.

--no-run Jump to heading#

Cache test modules, but don't run tests.

--permit-no-files Jump to heading#

Don't return an error code if no test files were found.

--reporter Jump to heading#

Select reporter to use. Default to 'pretty'.

--shuffle Jump to heading#

Shuffle the order in which the tests are run.

--trace-leaks Jump to heading#

Enable tracing of leaks. Useful when debugging leaking ops in test, but impacts test execution time.

File watching options Jump to heading#

--no-clear-screen Jump to heading#

Do not clear terminal screen when under watch mode.

--watch Jump to heading#

Watch for file changes and restart process automatically. Local files from entry point module graph are watched by default. Additional paths might be watched by passing them as arguments to this flag.

--watch-exclude Jump to heading#

Exclude provided files/patterns from watch mode.

Additional information Jump to heading#

It can be executed in watch mode (--watch), supports parallel execution (--parallel), and can be configured to run tests in a random order with (--shuffle). Additionally, there is built in support for code coverage (--coverage) and leak detection (--trace-leaks).

Examples Jump to heading#

Run tests

deno test

Run tests in specific files

deno test src/fetch_test.ts src/signal_test.ts

Run tests where glob matches

deno test src/*.test.ts

Run tests and skip type-checking

deno test --no-check

Run tests, re-running on file change

deno test --watch