@apideck/postman-to-k6

中文文档
1.14.4发布于 2026/10/13Apache-2.0CommonJS近 30 天下载 3756

将 Postman 收藏转换为 k6 JavaScript

中文使用文档
文档目录26 节
  1. 内容
  2. 特征
  3. 安装
  4. 局部安装(建议)
  5. 全球安装
  6. 使用量
  7. 视频介绍
  8. 选项
  9. 迭代数
  10. 环境变量
  11. 全球变量
  12. CSV 数据文件
  13. JSON 数据文件
  14. K6 参数选项文件
  15. K6 作为 JSON 处理摘要
  16. K6 请求标签
  17. 分开
  18. 跳过预览
  19. 跳过邮件
  20. CLI 选项文件
  21. 实例
  22. 测试
  23. 不支持的特性
  24. 资源
  25. 其他类似工具
  26. 贷项

postman-to-k6-cover

邮递员对k6

转换 a 邮递员收藏 改为 k6 脚本。 。 。 .

人到克6的转换器利用你的邮递员收藏,并转换所有邮递员请求,包括测试, 变量,... 到 K6 可执行的 K6 脚本进行性能测试.

Github badge npm npm

这个项目是原作的友好分叉 grafana/邮递员对k6 转换器,积极维护并开放新捐款.

随意贡献或通过任何改进后人对k6的建议.

内容

特征

  • 前所请文.
  • 测试脚本.
  • 变量(在所有范围+动态).
  • 数据文件.
  • 认证方法(霍克除外).
  • 文件上传(实验).
  • postman.* 接口( e)以下例外情况) (中文(简体) ).
  • pm.* 接口( e)以下例外情况) (中文(简体) ).
  • 支助 邮差 动态变量 打开 替换 函数.
  • Postman 曝光的全球变量 : globals environment data iteration。 。 。 .
  • xml2Json 转换.
  • 全体 邮政员Schema 各个版本.

安装

虽然有可能在全球安装,但我们建议,如果可能的话,将转换器添加到 node_modules 您的电话 使用 :

$ npm install -D @apideck/postman-to-k6

或者用纱线...

$ yarn add @apideck/postman-to-k6

请注意,这将需要您用 npx @apideck/postman-to-k6 your-postman-file 或者 如果你是的话 使用旧版本 npm, ./node_modules/.bin/postman-to-k6 your-postman-file。 。 。 .

全球安装

$ npm install -g @apideck/postman-to-k6

使用量

要将导出收藏转换为 k6 脚本 :

$ postman-to-k6 collection.json -o k6-script.js

然后像往常一样使用 k6 运行脚本 :

$ k6 run k6-script.js

视频介绍

与 尼科尔·范德霍芬 打开 保罗·巴洛格 从 K6队我们谈过了人对克6" 在 K6 办公小时 播客们 我们讨论了如何将邮递员的集合转换为k6载荷测试,邮递员的优点,以及重新使用自动化测试脚本进行性能测试的好处.

Postman for load testing using k6, with Tim Haselaars (k6 Office Hours #43)

在Youtube上看着点 https://www.youtube.com/watch?v=Be66Db4wHLA (中文(简体) )

所涉专题:

选项

迭代数

配置完成前要执行多少次脚本 .

旗帜声波默认
-i--iterations1个

示例

$ postman-to-k6 collection.json --iterations 25 -o k6-script.js

环境变量

从 JSON 文件提供环境变量 .

旗帜声波默认
-e--environment不详

示例

$ postman-to-k6 collection.json --environment environment.json -o k6-script.js

全球变量

从 JSON 文件提供全局变量 .

旗帜声波默认
-g--global不详
$ postman-to-k6 collection.json --global globals.json -o k6-script.js

CSV 数据文件

以 CSV 格式提供数据文件.

旗帜声波默认
-c--csv不详
$ postman-to-k6 collection.json --csv data.csv -o k6-script.js

JSON 数据文件

用 JSON 格式通过数据文件 .

旗帜声波默认
-j--json不详
$ postman-to-k6 collection.json --json data.json -o k6-script.js

K6 参数选项文件

过 K6 参数选项 作为JSON格式的文件.

旗帜声波默认
--k6-params不详
$ postman-to-k6 collection.json --k6-params k6-params.json -o k6-script.js

K6 作为 JSON 处理摘要

输出 K6摘要 作为文件 jSON格式。 这将会增加 K6 handleSummary(data) 到生成的脚本,提供 K6 的功能 将在本地存储摘要输出为 JSON 文件.

旗帜声波默认
--k6-handle-summary-json不详
$ postman-to-k6 collection.json --k6-handle-summary-json summary-report.json -o k6-script.js

K6 请求标签

生成 K6 请求名称标签 基于可用的命名 战略:

  • 无:没有自动生成的标签qq默认
  • request: 使用请求名称作为标签(例如“ 显示全部账户” )
  • folder-request: 使用 Postman 文件夹名和请求名( 例如:“ 账户 - 显示全部账户 ”)
旗帜声波默认
--k6-request-tagging不详

示例 request 战略

$ postman-to-k6 collection.json --k6-request-tagging=request -o k6-script.js

示例 folder-request 战略

$ postman-to-k6 collection.json --k6-request-tagging=folder-request -o k6-script.js

分开

将请求拆分为单独的文件, 以便更容易重排逻辑 .

旗帜声波默认
-s--separate虚假
$ postman-to-k6 collection.json --separate -o k6-script.js
$ postman-to-k6 collection.json -s -o k6-script.js

跳过预览

转换时跳过任何预请求脚本

旗帜声波默认
--skip-pre虚假
$ postman-to-k6 collection.json --skip-pre -o k6-script.js

跳过邮件

转换时跳过任何后请求脚本

旗帜声波默认
--skip-post虚假
$ postman-to-k6 collection.json --skip-pre -o k6-script.js

CLI 选项文件

在单独的配置文件中管理所有 CLI 选项, 并将其传递给 postman to- k6 命令 。 来做 比较容易使用CLI,特别是在CI/CD执行中.

所有可用的 CLI 选项都可以在配置文件中使用. 通过通过CLI选项作为参数,可以 覆盖文件中定义的 CLI 选项.

旗帜声波默认
--cli-options-file虚假
$ postman-to-k6 collection.json --cli-options-file cli-config.json

JSON CLI 配置文件示例

{
    "output": "k6-script.js",
    "k6-params": "config/k6-params.json",
    "environment": "config/envs/team.env.json",
    "separate": true
}

实例

邮递员实例汇编见以下 example。要运行其中的一个例子, 只需运行它,因为你会 其他命令 :

$ postman-to-k6 example/v2/echo.json -o k6-script.js

测试

运行测试套件 :

$ npm run test-jest

npm run test-jest 包括一名土生土长的警卫 tests/** (AVA型API失败或 mock-require) (中文(简体) ).

运行默认测试入口 :

$ npm run test-all

运行覆盖并生成一个综合摘要/趋势文物:

$ npm run coverage-all

npm run coverage-jest-regression 执行一个 Jest 覆盖回归门对 scripts/coverage/jest-coverage-baseline.json 最大滴数 0.30% 用于行/报表/功能/空白.

最佳本地测试规则 tests/**数字 :

  • 使用本地 Jest 断言( E)expect(...)仅此而已.
  • 不导入 AVA (import test from 'ava'(单位:千美元) tests/**。 。 。 .
  • 不使用 AVA 特定 API(test.serial, (中文(简体) ), t.is, (中文(简体) ), t.deepEqual, (中文(简体) ), t.throws(见a/c.5/49/70,附件).
  • 不使用 mock-require 内 tests/**;使用共享的 Jest shim 绑入 tests/helpers/shimHarness.js。 。 。 .

警卫司令部是:

$ npm run test-jest-native-guard

不支持的特性

  • 使用脚本发送请求 pm.sendRequest。 。 。 .
  • 使用控制请求执行命令 postman.setNextRequest。 。 。 .
  • Cookie 属性, 比如 hostOnly, (中文(简体) ), session,以及 storeId。 。 。 .
  • 邮递员的方法:
    • pm.response.reason
    • pm.response.to.have.status(reason)
    • pm.response.to.not.have.status(reason)
    • pm.request.auth
  • 鹰认证方法.
  • 折旧 xmlToJson 方法.
  • 申请身份证明更改。 邮递员在出口中不提供它们,所以我们必须产生出新的.

资源

关于邮递至k6的博客文章和资源集

其他类似工具

贷项

特别感谢来自 格拉法纳 用于开源和增殖 转换器和贡献给社区。 感谢 书月 用于创建此 工具。 还有,多亏了 波尔贾坎皮纳 用于创建工具的原始化身.

版本与发布记录

@apideck/postman-to-k6 共发布 26 个版本,首次发布于 2021/08/17;过去 12 个月发布了 5 个版本。

版本发布日期距今
1.14.4latest2026/10/1325 天前
1.14.32026/10/1325 天前
1.14.22026/05/235 个月前
1.14.12026/03/157 个月前
1.14.02026/03/147 个月前
1.13.02024/08/192 年前

关于 @apideck/postman-to-k6 的常见问题

@apideck/postman-to-k6 是什么?

将 Postman 收藏转换为 k6 JavaScript

如何安装 @apideck/postman-to-k6?

在项目目录运行 npm install @apideck/postman-to-k6,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 postman-to-k6,可以用 npx postman-to-k6 直接运行。

@apideck/postman-to-k6 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/apideck__postman-to-k6 是否存在。

@apideck/postman-to-k6 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@apideck/postman-to-k6 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.12.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@apideck/postman-to-k6 可以商用吗?

@apideck/postman-to-k6 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@apideck/postman-to-k6 的下载量有多少?

根据 npm 官方下载统计,@apideck/postman-to-k6 在 2026/10/06 – 2026/11/04 这 30 天内被下载 3,756 次,日均约 125 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@apideck/postman-to-k6 还在维护吗?

最新版本 1.14.4 发布于 2026/10/13(25 天前);至今共发布 26 个版本,其中过去 12 个月发布了 5 个;首次发布于 2021/08/17。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。