# @cypress/instrument-cra 中文文档

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

版本：1\.4\.0
npm 元数据更新时间：2025-10-27T19:16:37.258Z
中文译文更新时间：2026-11-11T07:17:24.292Z
软件包许可：MIT

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

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

弃用说明：Package no longer supported\. Contact Support at https://www\.npmjs\.com/support for more info\.

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

- 包体积（解压后）：8 kB，4 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：3 个
- 首次发布：2019-08-08T16:48:00.033Z
- 最新版本发布：2020-10-26T20:02:09.930Z
- 近 30 天下载量：82012（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：8（近 12 个月 0 个）

## 中文简介

CRA 应用到乐器代码的模块小而未弹出反应标记

## 安装

```sh
npm install @cypress/instrument-cra
```

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

## README

# @ cypress/instrument- cra (英语) [![renovate-app badge](https://img.shields.io/badge/renovate-app-blue.svg)](https://renovateapp.com/) [![CircleCI](https://circleci.com/gh/cypress-io/instrument-cra/tree/master.svg?style=svg&circle-token=50a3c2621735780756a505094eadb3cdca1699f2)](https://circleci.com/gh/cypress-io/instrument-cra/tree/master)

> CRA 应用到乐器代码的模块小而未弹出反应标记

## 安装和使用

```
yarn add @cypress/instrument-cra
```

那就换你的 `npm start` 启动 dev 服务器前需要此模块的脚本

```json
{
  "scripts": {
    "start": "react-scripts -r @cypress/instrument-cra start",
  }
}
```

本模块假定标准 [创建- react-App v3](https://github.com/facebook/create-react-app) JavaScript 应用程序在"src"文件夹中带有源文件.

当应用程序开始时 `yarn start`,您应当看到覆盖信息 `window.__coverage__` 资料.

![Coverage object](https://npmcn.com/package/%40cypress/instrument-cra/images/coverage.png)

仪器使用 [伊斯坦布尔.js](https://istanbul.js.org/) 通过 [巴尔-普拉金-斯坦布尔](https://github.com/istanbuljs/babel-plugin-istanbul) ,并与 [@ cypress/ code- 覆盖](https://github.com/cypress-io/code-coverage) 插件 .

## 排除文件

如果您想要将文件排除在覆盖范围之外, 例如 `src/serviceWorker.js`,添加一个已命名的对象 `nyc` 改为 `package.json` 之后 [nyc CLI 配置](https://github.com/istanbuljs/nyc#configuring-nyc)。 。 。 .

```json
{
  "nyc": {
    "exclude": "src/serviceWorker.js"
  }
}
```

## 工具 a分叉

文书a [叉数 `react-scripts`](https://create-react-app.dev/docs/alternatives-to-ejecting/),提供通往新 `webpack.config.js` 在你身边 `package.json` 作为 `cypressWebpackConfigPath`,例如:

```json
{
  "cypressWebpackConfigPath": "./node_modules/@my-org/my-react-scripts-fork/config/webpack.config.js"
}
```

## 强制仪器

通常,该代码只在 `development` 环境。 如果您想要强制使用仪器, 请设置环境变量

```
CYPRESS_INSTRUMENT_PRODUCTION=true
```

## 调试

以环境变量运行 `DEBUG=instrument-cra` 看到动词日志

## 页:1

如果您尝试启动应用程序,以及 `react-scripts` 显示出错 `There might be a problem with the project dependency tree.`,只需创建本地文件 `.env` 带。 这个问题是由于几个版本的 `babel-loader` 此插件与您的应用程序之间的依赖性 .

```
SKIP_PREFLIGHT_CHECK=true
```

## 实例

### 在此存储库中

-   [反应标记 v3](https://npmcn.com/package/%40cypress/instrument-cra/examples/react-scripts-v3)
-   [反应标记 v4](https://npmcn.com/package/%40cypress/instrument-cra/examples/react-scripts-v4)

### 外部

-   [反应 JavaScript app](https://github.com/bahmutov/testing-react)
-   [反应类型脚本应用程序](https://github.com/bahmutov/cra-ts-code-coverage-example)

## 许可证

麻省理工学院执照,见 [自由主义](https://npmcn.com/package/%40cypress/instrument-cra/LICENSE)

## 常见问题

### @cypress/instrument-cra 是什么？

CRA 应用到乐器代码的模块小而未弹出反应标记注意：该包已被作者标记为弃用——Package no longer supported\. Contact Support at https://www\.npmjs\.com/support for more info\.

### 如何安装 @cypress/instrument-cra？

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

### @cypress/instrument-cra 支持 TypeScript 吗？

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

### @cypress/instrument-cra 支持 ESM 还是 CommonJS？

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

### @cypress/instrument-cra 可以商用吗？

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

### @cypress/instrument-cra 的下载量有多少？

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

### @cypress/instrument-cra 还在维护吗？

最新版本 1\.4\.0 发布于 2020/10/27（6 年前）；至今共发布 8 个版本，其中过去 12 个月发布了 0 个；首次发布于 2019/08/09。作者已将其标记为弃用，新项目建议寻找替代方案。