jasmine-node 技术文档

1. 安装指南

要安装最新的官方版本，请使用 NPM：

npm install jasmine-node -g

如果要安装最新的 bleeding edge 版本，请克隆此仓库并检出 beta 分支。

2. 项目的使用说明

将您的代码规范写在 spec/ 目录下的 *.js 和 *.coffee 文件中。您可以使用子目录来更好地组织您的规范。在规范中使用 describe()、it() 等方法，与客户端 jasmine 规范完全相同。

注意：您的规范文件必须命名为 *spec.js、*spec.coffee 或 *spec.litcoffee，以匹配正则表达式 /spec\.(js|coffee|litcoffee)$/i；否则，jasmine-node 将无法找到它们！

例如，sampleSpecs.js 是错误的，sampleSpec.js 是正确的。

如果您已安装 npm 包，可以通过以下方式运行：

jasmine-node spec/

如果您没有使用 npm，请将 pwd/lib 添加到 $NODE_PATH 环境变量中，然后运行：

node lib/jasmine-node/cli.js

3. 项目API使用文档

以下是可以提供给用户的一些命令行参数：

• --autotest：在每个更改后自动执行规范。
• --watch：与 --autotest 一起使用时，将监视 --watch 后的路径变化，允许监视规范目录外的更改。
• --coffee：允许执行 .coffee 和 .litcoffee 规范。
• --color：指示规范输出应使用颜色来区分通过（绿色）或失败（红色）的规范。
• --noColor：在输出中不使用颜色。
• -m, --match REGEXP：仅匹配包含 "REGEXPspec" 的规范。
• --matchall：放宽规范文件名中 "spec" 的要求。
• --verbose：规范运行时的详细输出。
• --junitreport：将测试结果导出为 junitreport xml 格式。
• --output FOLDER：定义 junitreport 文件的输出文件夹。
• --teamcity：将所有控制台输出转换为 teamcity 自定义测试运行器命令（通常自动检测）。
• --growl：在 Growl 通知中显示测试运行摘要（需要单独安装 Growl）。
• --runWithRequireJs：使用 requirejs 而不是 node 的原生 require 方法加载所有规范。
• --requireJsSetup：在规范之前运行的文件，用于包含和配置 RequireJS。
• --test-dir：测试所在的绝对根目录路径。
• --nohelpers：不加载帮助函数。
• --forceexit：测试完成后强制退出。
• --captureExceptions：监听全局异常，报告并退出（与 Domains 在 NodeJs 中冲突，因此如果使用 Domains，请不要使用此选项）。
• --config NAME VALUE：在 process.env 中设置全局变量。
• --noStack：从测试失败中抑制堆栈跟踪。

单个文件可以作为裸参数添加到参数列表的末尾。

示例：

jasmine-node --coffee spec/AsyncSpec.coffee spec/CoffeeSpec.coffee spec/SampleSpec.js

4. 项目安装方式

请参考上述“安装指南”部分。

以上就是关于 jasmine-node 项目的技术文档，希望对您有所帮助。