deno test
命令行用法
deno test [OPTIONS] [files]... [-- [SCRIPT_ARG]...]
使用 Deno 内置的测试运行器运行测试。
评估给定的模块,运行所有用 Deno.test()
声明的测试,并将结果报告到标准输出
deno test src/fetch_test.ts src/signal_test.ts
目录参数会扩展到所有包含的文件,匹配 glob {*_,*.,}test.{js,mjs,ts,mts,jsx,tsx}
或 **/__tests__/**
deno test src/
类型检查选项 跳转到标题
--check
跳转到标题
设置类型检查行为。此子命令默认对本地模块进行类型检查,因此添加 --check
是多余的。如果提供 "all" 值,则会包含远程模块。或者,可以使用 'deno check' 子命令。
--no-check
跳转到标题
跳过类型检查。如果提供 "remote" 值,则会忽略来自远程模块的诊断错误。
依赖管理选项 跳转到标题
--cached-only
跳转到标题
要求远程依赖项已缓存。
--frozen
跳转到标题
如果 lockfile 过期,则报错。
--import-map
跳转到标题
从本地文件或远程 URL 加载 import map 文件。
--lock
跳转到标题
检查指定的 lock 文件。(如果未提供值,则默认为 "./deno.lock")。
--no-lock
跳转到标题
禁用自动发现 lock 文件。
--no-npm
跳转到标题
不解析 npm 模块。
--no-remote
跳转到标题
不解析远程模块。
--node-modules-dir
跳转到标题
设置 npm 包的 node modules 管理模式。
--reload
跳转到标题
短标记:-r
重新加载源代码缓存(重新编译 TypeScript) 无值:重新加载所有内容 jsr:@std/http/file-server,jsr:@std/assert/assert-equals: 重新加载特定模块 npm:: 重新加载所有 npm 模块 npm:chalk: 重新加载特定 npm 模块。
--vendor
跳转到标题
切换本地 vendor 文件夹的使用,用于远程模块,以及 node_modules 文件夹用于 npm 包。
选项 跳转到标题
--allow-scripts
跳转到标题
允许为给定的包运行 npm 生命周期脚本。注意:脚本仅在使用 node_modules 目录 (--node-modules-dir
) 时执行。
--cert
跳转到标题
从 PEM 编码的文件加载证书颁发机构。
--config
跳转到标题
短标记:-c
配置 deno 的不同方面,包括 TypeScript、代码检查和代码格式化。通常,配置文件将被称为 deno.json
或 deno.jsonc
并自动检测;在这种情况下,此标志不是必需的。
--env-file
跳转到标题
从本地文件加载环境变量。仅使用给定键的第一个环境变量。现有的进程环境变量不会被覆盖,因此如果环境中已存在同名变量,则其值将被保留。如果您的 .env 文件中存在同一环境变量的多个声明,则应用遇到的第一个声明。这由您作为参数传递的文件的顺序决定。
--ext
跳转到标题
设置提供的文件的内容类型。
--hide-stacktraces
跳转到标题
隐藏失败测试结果中错误的堆栈跟踪。
--ignore
跳转到标题
忽略文件。
--location
跳转到标题
globalThis.location 的值,供某些 Web API 使用。
--no-config
跳转到标题
禁用自动加载配置文件。
--parallel
跳转到标题
并行运行测试模块。并行度默认为可用 CPU 数量或 DENO_JOBS 环境变量的值。
--seed
跳转到标题
设置随机数生成器种子。
--v8-flags
跳转到标题
要查看所有可用标志的列表,请使用 --v8-flags=--help
。标志也可以通过 DENO_V8_FLAGS 环境变量设置。使用此标志设置的任何标志都附加在 DENO_V8_FLAGS 环境变量之后。
调试选项 跳转到标题
--inspect
跳转到标题
在 host:port 上激活检查器 [默认值: 127.0.0.1:9229]
--inspect-brk
跳转到标题
在 host:port 上激活检查器,等待调试器连接并在用户脚本的开头中断。
--inspect-wait
跳转到标题
在 host:port 上激活检查器,并等待调试器连接后再运行用户代码。
测试选项 跳转到标题
--clean
跳转到标题
在运行测试之前,清空临时覆盖率 profile 数据目录。注意:为同一覆盖率目录连续或并行运行多个 deno test --clean
调用可能会导致竞争条件。
--coverage
跳转到标题
将覆盖率 profile 数据收集到 DIR 中。如果未指定 DIR,则使用 'coverage/'。
--doc
跳转到标题
评估 JSDoc 和 Markdown 中的代码块。
--fail-fast
跳转到标题
在 N 个错误后停止。默认为在第一次失败后停止。
--filter
跳转到标题
运行测试名称中包含此字符串或正则表达式模式的测试。
--junit-path
跳转到标题
将 JUnit XML 测试报告写入 PATH。使用 '-' 写入 stdout,这是未提供 PATH 时的默认值。
--no-run
跳转到标题
缓存测试模块,但不运行测试。
--permit-no-files
跳转到标题
如果没有找到测试文件,则不返回错误代码。
--reporter
跳转到标题
选择要使用的 reporter。默认为 'pretty'。
--shuffle
跳转到标题
随机化测试运行的顺序。
--trace-leaks
跳转到标题
启用泄漏追踪。在调试测试中泄漏的 ops 时很有用,但会影响测试执行时间。
文件监视选项 跳转到标题
--no-clear-screen
跳转到标题
在监视模式下不清除终端屏幕。
--watch
跳转到标题
监视文件更改并自动重启进程。默认情况下,监视入口点模块图中的本地文件。可以通过将其他路径作为参数传递给此标志来监视它们。
--watch-exclude
跳转到标题
从监视模式中排除提供的文件/模式。
附加信息 跳转到标题
它可以在监视模式 (--watch
) 下执行,支持并行执行 (--parallel
),并且可以配置为使用 (--shuffle
) 以随机顺序运行测试。此外,还内置了对代码覆盖率 (--coverage
) 和泄漏检测 (--trace-leaks
) 的支持。
示例 跳转到标题
运行测试
deno test
在特定文件中运行测试
deno test src/fetch_test.ts src/signal_test.ts
运行 glob 匹配的测试
deno test src/*.test.ts
运行测试并跳过类型检查
deno test --no-check
运行测试,在文件更改时重新运行
deno test --watch