Postman Newman 命令选项
Newman 提供了一组丰富的选项来自定义运行。您可以通过运行带标志的 Newman 来检索选项列表-h。
$ newman run -h基本选项
| 选项 | 细节 |
|---|---|
-h,--help | 输出使用信息 |
-v,--version | 输出版本号 |
设置
| 选项 | 细节 |
|---|---|
--folder [folderName] | 指定要从集合中运行的单个文件夹。 |
-e,--environment [file|URL] | 将 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] | 指定等待整个收集运行完成执行的时间（以毫秒为单位）。 |
--timeout-request [number] | 指定请求的请求超时（以毫秒为单位）。 |
--timeout-script [number] | 指定等待脚本完成执行的时间（以毫秒为单位）。 |
杂项选项
| 选项 | 细节 |
|---|---|
--bail | 当测试用例失败时停止运行器。 |
--silent | 关闭终端输出。 |
--color off | 关闭彩色输出（auto|on|off）（默认值：“auto”） |
--disable-unicode | 强制禁用 unicode 选项。提供后，输出中的所有符号都将替换为它们的纯文本等效项。 |
-k,--insecure | 关闭严格的 SSL。 |
-x,--suppress-exit-code | 即使在失败后继续运行测试，但退出code=0 |
--ignore-redirects | 关闭自动跟踪响应3XX。 |
--verbose | 显示收集运行和发送的每个请求的详细信息。 |
--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