跳到主要内容

Newman 命令选项

Newman 提供了一组丰富的选项来自定义运行。你可以通过运行带标志的 Newman 来检索选项列表-h

基本选项

选项细节
-h,--help输出使用信息
-v,--version输出版本号

设置

选项细节
--folder [folderName]指定要从集合中运行的单个文件夹。
-e,`--environment [fileURL]`将 Postman 环境指定为 JSON [文件]
-d,--iteration-data [file]指定要使用的数据文件,JSON 或 CSV。
-g,--globals [file]将 Postman 全局文件指定为 JSON [文件]
-n,--iteration-count [number]定义要运行的迭代次数。
--working-dir [path]设置读取具有相对路径的文件时要使用的工作目录的路径。默认为当前目录。
--no-insecure-file-read防止读取位于工作目录之外的文件。
--export-environment [path]Newman 在完成运行之前将输出最终环境变量文件的文件路径。
--export-globals [path]Newman 将在完成运行前输出最终全局变量文件的文件路径。
--export-collection [path]Newman 将在完成运行前输出最终收集文件的文件路径。

请求选项

选项细节
--delay-request [number]指定请求之间的延迟(以毫秒为单位)[number]
--timeout [number]指定等待整个 collection run 完成执行的时间(以毫秒为单位)。
--timeout-request [number]指定请求的请求超时(以毫秒为单位)。
--timeout-script [number]指定等待脚本完成执行的时间(以毫秒为单位)。

杂项选项

选项细节
--bail当测试用例失败时停止运行器。
--silent关闭终端输出。
--color off关闭彩色输出(autoonoff)(默认值:“auto”)
--disable-unicode强制禁用 unicode 选项。提供后,输出中的所有符号都将替换为它们的纯文本等效项。
-k,--insecure关闭严格的 SSL。
-x,--suppress-exit-code即使在失败后继续运行测试,但退出code=0
--ignore-redirects关闭自动跟踪响应3XX
--verbose显示 collection run 和发送的每个请求的详细信息。
--cookie-jar [path]指定 JSON Cookie Jar 的文件路径。用于tough-cookie反序列化文件。
--export-cookie-jar [path]Newman 将在完成运行前输出最终 cookie jar 文件的文件路径。用于tough-cookie序列化文件。
--global-var "[global-variable-name]=[global-variable-value]"在命令行上以键=值格式指定全局变量。可以多次使用添加多个全局变量--global-var,例如,--global-var "this=that" --global-var "alpha=beta".
--env-var "[environment-variable-name]=[environment-variable-value]"允许你在命令行上以键=值格式设置环境变量。你可以使用--env-var多次添加多个环境变量,例如:--env-var "key1=value1" --env-var "key2=value2".

退出状态

默认情况下,如果一切运行良好,例如没有任何异常,Newman 会以状态码 0 退出。

持续集成 (CI) 工具响应这些退出代码并相应地通过或失败构建。

你可以使用-x--suppress-exit-code覆盖当前运行的默认退出代码。

你可以使用该--bail标志告诉 Newman 在出现状态代码为 1 的测试用例错误时停止,然后 CI 工具或构建系统可以拾取该错误。

$ newman run PostmanCollection.json -e environment.json --bail

数据文件示例

要提供不同的数据集,例如每次迭代的变量,你可以使用标志-d指定 JSON 或 CSV 文件。

例如,如下所示的数据文件运行两次迭代,每次迭代使用一组变量。

[{
"url": "http://127.0.0.1:5000",
"user_id": "1",
"id": "1",
"token_id": "123123",
},
{
"url": "http://postman-echo.com",
"user_id": "2",
"id": "2",
"token_id": "899899",
}]
$ newman run mycollection.json -d data.json

下面是这组变量的 CSV 文件示例:

url, user_id, id, token_id
http://127.0.0.1:5000, 1, 1, 123123123
http://postman-echo.com, 2, 2, 899899