# test-exclude 中文文档

规范地址：https://npmcn.com/package/test-exclude/

版本：8\.0\.0
npm 元数据更新时间：2026-02-22T17:10:34.191Z
中文译文更新时间：2026-11-05T15:59:37.498Z
软件包许可：ISC

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

原始 npm 页面：https://www.npmjs.com/package/test-exclude
原文对照：https://npmcn.com/package/test-exclude/?lang=original
项目主页：https://istanbul.js.org/
源码仓库：https://github.com/istanbuljs/test-exclude

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

- 包体积（解压后）：11.5 kB，7 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：20 \|\| \>=22
- 运行依赖：3 个
- 首次发布：2016-06-06T05:56:20.333Z
- 最新版本发布：2026-02-22T17:10:34.067Z
- 近 30 天下载量：258201256（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：40（近 12 个月 2 个）

## 中文简介

包含或排除路径

## 安装

```sh
npm install test-exclude
```

也可以使用：`pnpm add test-exclude`、`yarn add test-exclude`、`bun add test-exclude`

## README

# 测试 - 排除e

文件包含/ 排除逻辑 [无](https://github.com/istanbuljs/nyc) 财务报告和审定财务报表 [巴尔-普拉金-斯坦布尔](https://github.com/istanbuljs/babel-plugin-istanbul)。 。 。 .

[![Build Status](https://travis-ci.org/istanbuljs/test-exclude.svg)](https://travis-ci.org/istanbuljs/test-exclude) [![Coverage Status](https://coveralls.io/repos/github/istanbuljs/test-exclude/badge.svg?branch=master)](https://coveralls.io/github/istanbuljs/test-exclude?branch=master) [![Standard Version](https://img.shields.io/badge/release-standard%20version-brightgreen.svg)](https://github.com/conventional-changelog/standard-version) [![Greenkeeper badge](https://badges.greenkeeper.io/istanbuljs/test-exclude.svg)](https://greenkeeper.io/)

## 使用量

```js
const TestExclude = require('test-exclude');
const exclude = new TestExclude();
if (exclude().shouldInstrument('./foo.js')) {
    // let's instrument this file for test coverage!
}
```

### 测试Explex( 选项)

测试排除构造器接受一个选项对象。 默认取自 [@ istanbuljs/ schema (英语)](https://github.com/istanbuljs/schema)。 。 。 .

#### 选项.cwd

这是进行所有比较的基础目录。 外部文件 `cwd` 未列入.

默认 : `process.cwd()`

#### 选项

路径模糊的阵列将被忽略 。 注意本列表不包括 `node_modules` 哪个 单独添加。 见 [@istanbuljs/schema/ 默认- 排除. js](https://github.com/istanbuljs/schema/blob/master/default-exclude.js) 用于默认列表.

#### 选项。不包括节点模块

默认 `node_modules` 除外。 设置此选项 `true` 允许 `node_modules` 将列入.

#### 选项。包含

可包含的路由光谱矩阵 。 默认这是无限制的结果 类似 `['**']` 但更优化.

#### 选项。扩展

可包含的扩展序列 。 这保证了尼克只尝试处理 它可能理解的文件。 一些格式的注解使用可能需要添加解析器 您的 nyc 或 bail 配置的插件 .

默认 : `['.js', '.cjs', '.mjs', '.ts', '.tsx', '.jsx']`

### 测试Explex# should instrument( 文件名):布尔

测试是否 `filename` 匹配此测试排除实例的规则.

```js
const exclude = new TestExclude();
exclude.shouldInstrument('index.js'); // true
exclude.shouldInstrument('test.js'); // false
exclude.shouldInstrument('README.md'); // false
exclude.shouldInstrument('node_modules/test-exclude/index.js'); // false
```

在此示例代码中:

-   `index.js` 是真的,因为它符合默认值 `options.extension` 列表 而不属于默认 `options.exclude` 列表中选择一个选项.
-   `test.js` 被排除,因为它与默认匹配 `options.exclude` 列表中选择一个选项.
-   `README.md` 默认不匹配 `options.extension`
-   `node_modules/test-exclude/index.js` 被排除在外的原因是 `options.excludeNodeModules` 默认为真实.

### TestExculde# globSync( cwd = option.cwd): 阵列\[字符串\]

此同步获取文件列表 `cwd` 它应该有工具. 注意设置 `cwd` 给父母的 `options.cwd` 无效, 此参数可以 只用于进一步限制结果.

### 测试Explex# glob( cwd = option. cwd): 保证 < Array\[string\] >

此函数与 `TestExclude#globSync` 却会同步进行 这个 保证会决定一串弦.

## `test-exclude` 企业

作为Tidelift订阅的一部分提供.

维护者 `test-exclude` 和上千个其他的软件包 正在和Tidelift合作 提供商业支持和维护 你用来构建应用程序的开源依赖。 节省时间,降低风险,改善代码健康,同时向维护者支付使用的确切依赖性. [学多取.](https://tidelift.com/subscription/pkg/npm-test-exclude?utm_source=npm-test-exclude&utm_medium=referral&utm_campaign=enterprise&utm_term=repo)

## 常见问题

### test-exclude 是什么？

包含或排除路径

### 如何安装 test-exclude？

在项目目录运行 npm install test-exclude，或使用 pnpm add / yarn add / bun add。

### test-exclude 支持 TypeScript 吗？

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

### test-exclude 支持 ESM 还是 CommonJS？

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

### test-exclude 需要什么版本的 Node\.js？

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

### test-exclude 可以商用吗？

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

### test-exclude 的下载量有多少？

根据 npm 官方下载统计，test-exclude 在 2026/10/05 – 2026/11/03 这 30 天内被下载 258,201,256 次，日均约 8,606,709 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### test-exclude 还在维护吗？

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