On this page
deno test
Command-line Usage
deno test [OPTIONS] [files]... [-- [SCRIPT_ARG]...]
Run tests using Deno's built-in test runner.
Evaluate the given modules, run all tests declared with Deno.test()
and report results to standard output:
deno test src/fetch_test.ts src/signal_test.ts
Directory arguments are expanded to all contained files matching the glob {*_,*.,}test.{js,mjs,ts,mts,jsx,tsx}
or **/__tests__/**
:
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
--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