# @cardano-sdk/util-dev 中文文档

规范地址：https://npmcn.com/package/%40cardano-sdk/util-dev/

版本：0\.25\.38
npm 元数据更新时间：2026-09-25T13:53:57.161Z
中文译文更新时间：2026-11-09T04:20:00.026Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40cardano-sdk/util-dev
原文对照：https://npmcn.com/package/%40cardano-sdk/util-dev/?lang=original
项目主页：https://github.com/input-output-hk/cardano-js-sdk#readme
源码仓库：https://github.com/input-output-hk/cardano-js-sdk

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

- 包体积（解压后）：5.8 MB，278 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：17 个
- 首次发布：2021-10-05T11:44:18.179Z
- 最新版本发布：2026-09-25T13:53:56.920Z
- 近 30 天下载量：29981（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：208（近 12 个月 6 个）

## 中文简介

其他包件测试用费

## 安装

```sh
npm install @cardano-sdk/util-dev
```

也可以使用：`pnpm add @cardano-sdk/util-dev`、`yarn add @cardano-sdk/util-dev`、`bun add @cardano-sdk/util-dev`

## README

# Cardano JS SDK SDK 互联网档案馆的存檔,存档日期2013-12-21

其他包件测试用费

## 测试

见 [代码覆盖报告](https://input-output-hk.github.io/cardano-js-sdk/coverage/util-dev)。 。 。 .

## 测试

A 类 _单位测试_ 专用 _日志_。 。 。 .

```typescript
import { createLogger, logger } from '@cardano-sdk/util-dev';
import { deepStrictEqual } from 'assert';

logger.debug('Some debug data');
logger.error('Some error data');
// etc...

const newLogger = createLogger({ record: true });

newLogger.info('another message');
newLogger.debug({ test: 42 }, 'some message');
newLogger.error('error message', new Error('example error'));

deepStrictEqual(newLogger.messages, [
  { level: 'info', message: ['another message'] },
  { level: 'debug', message: [{ test: 42 }, 'some message'] },
  { level: 'error', message: ['error message', new Error('example error')] }
]);
```

此记录器被明确设计为用于单位测试: 它使单位测试输出尽可能干净( 仅使用 `fatal` )),但在必要时,它提供了快速而容易的方法来增加测试的动词性而无需修改任何文件.

也提供了录音的选择 **全部登录值** 检查测试程序记录的内容.

### 测试开发流程

在开发/维持/审查单位测试时,我们经常从壳体运行单位测试命令:

```
yarn test
```

只要所有测试都通过 我们甚至不需要 `TestLogger`。 。 。 .

但有时有些测试失败... 有时...

为了调查测试失败的原因,访问日志可能有用.

如果测试是使用 `TestLogger`,后者允许我们通过简单的环境变量访问和/或自定义日志.

要增加日志级别,只需使用 `TL_LEVEL` 环境变量 :

```
TL_LEVEL=info yarn test
```

默认, `TestLogger` 用途 [用户检查](https://nodejs.org/api/util.html#utilinspectobject-options) 联 合 国 `options` 对象可以使用下列环境变量进行定制:

-   `TL_ARRAY` 地图到 `maxArrayLength`默认为 `100`。 。 。 . `0` 地图到 `Infinity`。 。 。 .
-   `TL_BREAK` 地图到 `breakLength`。默认在 tty 或 `90` 否则. `0` 地图到 `Infinity`。 。 。 .
-   `TL_COLOR` 地图到 `colors`默认为 `true` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}就一块 `false` 否则.
-   `TL_COMPACT` 地图到 `compact`默认为 `3`。 。 。 . `0` 地图到 `false`。 。 。 .
-   `TL_DEPTH` 地图到 `depth`默认为 `2`。 。 。 . `0` 地图到 `Infinity`。 。 。 .
-   `TL_HIDDEN` 地图到 `showHidden`默认为 `false`。 。 。 .
-   `TL_PROXY` 地图到 `showProxy`默认为 `false`。 。 。 .
-   `TL_STRING` 地图到 `maxStringLength`默认为 `1000` (无) `10000` 作为 `util.inspect` 页:1. `0` 地图到 `Infinity`。 。 。 .

因此,如果(例如)我们需要记录完整的嵌入物和 `Proxy`我们可以运行我们的测试命令:

```
TL_PROXY=true TL_DEPTH=0 TL_LEVEL=info yarn test
```

虽然 `util.inspect` 它可以被深度定制(让我们也自定义我们的日志),它的缺点是它的输出不能被剪切并粘贴在源文件上或者执行POST等. 如果我们需要从日志上切出一些东西 我们可以指示 `TestLogger` 用于 `JSONBig.stringify` 相反,这显然会使 `TestLogger` 忽略自定义的环境变量 `util.inspect`。 。 。 .

```
TL_LEVEL=info TL_JSON=true yarn test
```

## 常见问题

### @cardano-sdk/util-dev 是什么？

其他包件测试用费

### 如何安装 @cardano-sdk/util-dev？

在项目目录运行 npm install @cardano-sdk/util-dev，或使用 pnpm add / yarn add / bun add。

### @cardano-sdk/util-dev 支持 TypeScript 吗？

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

### @cardano-sdk/util-dev 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @cardano-sdk/util-dev 需要什么版本的 Node\.js？

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

### @cardano-sdk/util-dev 可以商用吗？

@cardano-sdk/util-dev 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @cardano-sdk/util-dev 的下载量有多少？

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

### @cardano-sdk/util-dev 还在维护吗？

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