@amadeus-it-group/kassette

中文文档
1.7.6发布于 2026/04/16MITTypeScriptCommonJS构建来源已验证近 30 天下载 1.3万

开发服务器,主要用于测试,它能代理请求,并能轻松地管理本地模拟.

中文使用文档
文档目录5 节
  1. 主要特点
  2. 安装
  3. 从 git 克隆安装
  4. 用户文档
  5. 发展/贡献

卡赛特

npm codecov

kassette-logo
kassette 是一个开发服务器,主要用于测试,用于代理请求和
能够轻松地管理本地模拟.

用来:

  • 安装为 npm install @amadeus-it-group/kassette
  • 将此命令添加到您的 package.json 脚本 : kassette -c kassette.config.js
  • 创建配置文件 kassette.config.js数字 :
/**
 * @return { import("@amadeus-it-group/kassette").ConfigurationSpec }
 */
exports.getConfiguration = () => {
  return {
    port: 4200,
    mocksFolder: './mocks-folder',
    remoteURL: 'http://127.0.0.1:3000',
    mode: 'local_or_download',

    hook: async ({ mock }) => {
      if (!mock.request.pathname.startsWith('/api/')) {
        mock.setMode('remote');
        return;
      }

      mock.setLocalPath([mock.request.pathname.split('/').slice(1), mock.request.method]);
    },
  };
};

现在运行您的脚本启动代理!

使用此配置, 输入请求以 URL 为目标 /api/ 将进行处理,如果存在,将使用本地模拟,否则数据将从 http://127.0.0.1:3000 与转交的请求一起,持续进行并用于今后的输入请求.

注意kassette也可以被配置为浏览器代理运行,从请求中读取目标URL,并截取HTTPS通信.

检查 开始 学习更多.

主要特点

  • 可选择将请求转发到远程后端
  • 记录后端响应供以后使用
  • 易于计算和设置本地模拟路径
  • 从后端响应中填写对客户端的回复,下载或持续
  • 手动修改对客户端的响应
  • 可选择充当浏览器代理
  • 在苍蝇上生成 TLS 证书以截取 HTTPS 通讯( 作为正中人物)
  • 很好地整合到您的编辑器和源控制中:一个简单的文件等级系统以干净的方式生成,用于检查,版面,diffing等.
  • 支持 HAR 格式 在 JSON 或 YAML 中记录和重放游戏
  • 在客户端和服务器中支持 HTTP/ 1.x 和 HTTP/2.0

安装

这是一个使用 npm 进行依赖管理的 Node.js 项目,所以确保您能正确安装这两个 。 已支持Node.js LTS起步.

Npm可以安装在两个位置:

  • 本地在您的项目中运行它 通常的方式(使用 npm 脚本 或明确访问路径 node_modules/.bin/kassette(中文(简体) )
  • 或在全球安装并使用命令运行 kassette (未就自成一体的项目提供建议)

除了安装的地方,你至少有两种方法安装它:

  • 从 npm 注册: packet 名称为 @amadeus-it-group/kassette
  • 从 git 克隆(见下文)

从 git 克隆安装

清除此寄存器并运行 npm link 把它安装在电脑上.

如果你想在全球范围内使用,那就没有什么可做的了.

如果您想要在本地安装, 您需要添加一个步骤 。 你将无法使用 package.json 依赖性,但您可以手动安装 npm link @amadeus-it-group/kassette 从你的项目内部.

用户文档

建议从 开始 描述一些实用用法实例的文章,然后检查 配置指南 编辑 API 指南编辑 API 参考 还提供.

发展/贡献

见 开发者指南 详细情况.

版本与发布记录

@amadeus-it-group/kassette 共发布 18 个版本,首次发布于 2020/10/12;过去 12 个月发布了 3 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.7.6latest2026/04/166 个月前
1.7.52026/03/038 个月前
1.7.42026/02/208 个月前
1.7.32025/10/151.1 年前
1.7.22025/04/111.6 年前
1.7.12024/11/281.9 年前

关于 @amadeus-it-group/kassette 的常见问题

@amadeus-it-group/kassette 是什么?

开发服务器,主要用于测试,它能代理请求,并能轻松地管理本地模拟.

如何安装 @amadeus-it-group/kassette?

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

@amadeus-it-group/kassette 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@amadeus-it-group/kassette 支持 ESM 还是 CommonJS?

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

@amadeus-it-group/kassette 需要什么版本的 Node.js?

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

@amadeus-it-group/kassette 可以商用吗?

@amadeus-it-group/kassette 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@amadeus-it-group/kassette 的下载量有多少?

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

@amadeus-it-group/kassette 还在维护吗?

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