# @bahmutov/cypress-extends 中文文档

规范地址：https://npmcn.com/package/%40bahmutov/cypress-extends/

版本：1\.1\.0
npm 元数据更新时间：2022-04-04T17:30:41.301Z
中文译文更新时间：2026-11-07T15:04:42.270Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：5.5 kB，3 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：2 个
- 首次发布：2020-05-27T12:40:43.749Z
- 最新版本发布：2020-11-09T17:50:28.648Z
- 近 30 天下载量：29776（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 0 个）

## 中文简介

为配置文件添加“ 扩展” 支持的 Cypress 插件

## 安装

```sh
npm install @bahmutov/cypress-extends
```

也可以使用：`pnpm add @bahmutov/cypress-extends`、`yarn add @bahmutov/cypress-extends`、`bun add @bahmutov/cypress-extends`

## README

# @bahmutov/cypress-extends (英语) [![renovate-app badge](https://img.shields.io/badge/renovate-app-blue.svg)](https://renovateapp.com/) [![ci status](https://github.com/bahmutov/cypress-extends/workflows/ci/badge.svg?branch=master)](https://github.com/bahmutov/cypress-extends/actions) [![badges status](https://github.com/bahmutov/cypress-extends/workflows/badges/badge.svg?branch=master)](https://github.com/bahmutov/cypress-extends/actions) ![cypress version](https://img.shields.io/badge/cypress-5.5.0-brightgreen)

> Cypress插件在配置文件中添加"扩展"支持. 这使得配置文件能够保留 DRY并避免重复数据,但仍有多个文件用于不同的情景. 详情见 [扩展 Cypress 配置文件](https://www.cypress.io/blog/2020/06/18/extending-the-cypress-config-file/) 博客文章.

## 使用

```
npm i -D @bahmutov/cypress-extends
# or
yarn add -D @bahmutov/cypress-extends
```

将此模块添加到您的 `cypress/plugins/index.js` 文件

```js
module.exports = (on, config) => {
  // `on` is used to hook into various events Cypress emits
  // `config` is the resolved Cypress config
  return require('@bahmutov/cypress-extends')(config.configFile)
}
```

开始使用 `extends` cypress 配置文件中的语法

```
// cypress.json
{
  "extends": "./base.json"
}
// base.json
{
  "fixturesFolder": false,
  "supportFile": false,
  "$schema": "https://on.cypress.io/cypress.schema.json"
}
```

**提示 :** 页:1 `$schema` 属性在 JSON 文件允许现代 IDE 显示 Cypress 配置值的智能代码补全.

![Schema](https://npmcn.com/package/%40bahmutov/cypress-extends/images/schema.gif)

## 调试

用环境变量运行 Cypress

```
DEBUG=@bahmutov/cypress-extends npx cypress run
# or
DEBUG=@bahmutov/cypress-extends npx cypress open
```

## 更多信息

读取 [Cypress 小费和把戏](https://glebbahmutov.com/blog/cypress-tips-and-tricks/) 看着 [Cypress 提示](https://www.youtube.com/playlist?list=PLP9o9QNnQuAYYRpJzDNWpeuOVTwxmIxcI) 视频.

### 小印数

作者: Gleb Bahmutov <gleb.bahmutov@gmail.com> 2020 (英语)

-   [@bahmutov (英语)](https://twitter.com/bahmutov)
-   [glebbahmutov.com (中文(简体) )](https://glebbahmutov.com/)
-   [博客](https://glebbahmutov.com/blog)

许可:麻省理工学院 - 做任何与代码有关的事情, 但如果它不起作用,不要责怪我.

支持: 如果您发现此模块有任何问题, 电子邮件 / 微博 / [未决问题](https://github.com/bahmutov/cypress-extends/issues) 在基图布

## MIT 许可证

版权 (c) 2020 Gleb Bahmutov <gleb.bahmutov@gmail.com>

特此免费准许任何人 获取该软件和相关文件的副本 文件(“软件”),在软件中处理,不包含 限制,包括不限制使用权, 复制、修改、合并、出版、发行、分版和/或销售 软件的复制本,并允许向 为此提供了软件,但须符合下列条件: 条件:

上述版权通知和本许可通知应为: 列入软件的所有副本或大部分.

软件是提供的"是", 没有任何种类的恐惧, 或监禁,包括但不限制于 特别目的和目的的证明 无所不入。 绝对不能让警察或警察 B. 任何索赔、救济或其他负债的持有者, 条约、条约或其他条约行动 来源、来源或与溶剂或使用有关的 其他交易 在软件.

## 常见问题

### @bahmutov/cypress-extends 是什么？

为配置文件添加“ 扩展” 支持的 Cypress 插件

### 如何安装 @bahmutov/cypress-extends？

在项目目录运行 npm install @bahmutov/cypress-extends，或使用 pnpm add / yarn add / bun add。

### @bahmutov/cypress-extends 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/bahmutov\_\_cypress-extends 是否存在。

### @bahmutov/cypress-extends 支持 ESM 还是 CommonJS？

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

### @bahmutov/cypress-extends 可以商用吗？

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

### @bahmutov/cypress-extends 的下载量有多少？

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

### @bahmutov/cypress-extends 还在维护吗？

最新版本 1\.1\.0 发布于 2020/11/10（5 年前）；至今共发布 2 个版本，其中过去 12 个月发布了 0 个；首次发布于 2020/05/27。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。