# @amadeus-it-group/kassette 中文文档

规范地址：https://npmcn.com/package/%40amadeus-it-group/kassette/

版本：1\.7\.6
npm 元数据更新时间：2026-04-16T13:52:43.406Z
中文译文更新时间：2026-11-05T23:22:05.926Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40amadeus-it-group/kassette
原文对照：https://npmcn.com/package/%40amadeus-it-group/kassette/?lang=original
项目主页：https://github.com/AmadeusITGroup/kassette#readme
源码仓库：https://github.com/AmadeusITGroup/kassette

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：237 kB，65 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=10\.0\.0
- 运行依赖：10 个
- 首次发布：2020-10-12T12:18:14.309Z
- 最新版本发布：2026-04-16T13:52:43.065Z
- 近 30 天下载量：12945（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：18（近 12 个月 3 个）

## 中文简介

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

## 安装

```sh
npm install @amadeus-it-group/kassette
```

也可以使用：`pnpm add @amadeus-it-group/kassette`、`yarn add @amadeus-it-group/kassette`、`bun add @amadeus-it-group/kassette`

## README

# 卡赛特

[![npm](https://img.shields.io/npm/v/@amadeus-it-group/kassette)](https://www.npmjs.com/package/@amadeus-it-group/kassette) [![codecov](https://codecov.io/gh/AmadeusITGroup/kassette/branch/master/graph/badge.svg)](https://codecov.io/gh/AmadeusITGroup/kassette)

![kassette-logo](https://raw.githubusercontent.com/AmadeusITGroup/kassette/master/doc/assets/images/kassette-logo.png)  
_kassette 是一个开发服务器,主要用于测试,用于代理请求和  
能够轻松地管理本地模拟._  

用来:

-   安装为 `npm install @amadeus-it-group/kassette`
-   将此命令添加到您的 `package.json` 脚本 : `kassette -c kassette.config.js`
-   创建配置文件 `kassette.config.js`数字 :

```javascript
/**
 * @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通信.

检查 [_开始_](https://github.com/AmadeusITGroup/kassette/blob/master/doc/getting-started.md) 学习更多.

## 主要特点

-   可选择将请求转发到远程后端
-   记录后端响应供以后使用
-   易于计算和设置本地模拟路径
-   从后端响应中填写对客户端的回复,下载或持续
-   手动修改对客户端的响应
-   可选择充当浏览器代理
-   在苍蝇上生成 TLS 证书以截取 HTTPS 通讯( 作为正中人物)
-   很好地整合到您的编辑器和源控制中:一个简单的文件等级系统以干净的方式生成,用于检查,版面,diffing等.
-   支持 [HAR 格式](http://www.softwareishard.com/blog/har-12-spec/) 在 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` 从你的项目内部.

## 用户文档

建议从 [_开始_](https://github.com/AmadeusITGroup/kassette/blob/master/doc/getting-started.md) 描述一些实用用法实例的文章,然后检查 [配置指南](https://github.com/AmadeusITGroup/kassette/blob/master/doc/configuration.md) 编辑 [API 指南](https://github.com/AmadeusITGroup/kassette/blob/master/doc/api.md)编辑 [API 参考](https://amadeusitgroup.github.io/kassette/) 还提供.

## 发展/贡献

见 [开发者指南](https://github.com/AmadeusITGroup/kassette/blob/master/DEVELOPER.md) 详细情况.

## 常见问题

### @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 和提交记录判断。