# @dynatrace-sdk/shared-client-utils 中文文档

规范地址：https://npmcn.com/package/%40dynatrace-sdk/shared-client-utils/

版本：1\.0\.1
npm 元数据更新时间：2025-07-15T14:21:01.171Z
中文译文更新时间：2026-11-13T02:47:04.001Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40dynatrace-sdk/shared-client-utils
原文对照：https://npmcn.com/package/%40dynatrace-sdk/shared-client-utils/?lang=original

弃用说明：Deprecated

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

- 包体积（解压后）：52.7 kB，15 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2025-07-15T13:28:40.933Z
- 最新版本发布：2025-07-15T13:28:41.219Z
- 近 30 天下载量：10603（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 0 个）

## 中文简介

\---标题:"@dynatrace-sdk/shared-client-utils"描述: ---

## 安装

```sh
npm install @dynatrace-sdk/shared-client-utils
```

也可以使用：`pnpm add @dynatrace-sdk/shared-client-utils`、`yarn add @dynatrace-sdk/shared-client-utils`、`bun add @dynatrace-sdk/shared-client-utils`

## README

* * *

## 标题 : "@ dynatrace-sdk/ slow-client-utils" 说明 :

# @ dynatrace- sdk/ 共享客户端- utils

```bash
npm install @dynatrace-sdk/shared-client-utils
```

## 职能

### apiGateway ErrorsHandler (英语:Api Gateway ErrorsHandler) (美国英语)

**apiGateway ErrorsHandler( 答复): 保证<有效>**

处理 API 网关回复中的错误 . 如果响应源为"API Gateway",则丢出 ApiGateway Error .

#### 参数

| 名称 | 类型 | 说明 |
| --- | --- | --- |
| 回应\*必须 | Http 客户端响应 | HTTP 检查 API 网关出错的响应 . |

### 获取错误

**获得 ErrorMessage(ERRORBody,默认Message):\[字符串\](https://developer.mozilla.org/en-US/docs/Glossary/String)**

从错误对象返回方便用户的错误消息.

#### 参数

| 名称 | 类型 | 说明 |
| --- | --- | --- |
| 错误Body\*必须 | 不详 | 错误对象或响应机构可以提取消息. |
| 默认信息\*必须 | [字符串](https://developer.mozilla.org/en-US/docs/Glossary/String) | 如果没有找到错误消息, 则使用默认信件 . |

#### 回返

| 返回类型 | 说明 |
| --- | --- |
| [字符串](https://developer.mozilla.org/en-US/docs/Glossary/String) | 提取出或默认错误消息, 可能包括细节 . |

### mIME 代码

**mIME TypeTO 编码( imeType, 默认编码 ) : 编码**

将 MIME 类型字符串映射到编码中.

#### 参数

| 名称 | 类型 | 说明 |
| --- | --- | --- |
| 缩写\*必须 | [字符串](https://developer.mozilla.org/en-US/docs/Glossary/String) | 要转换的MIME类型( 如 “ 应用程序/ json ”) . |
| 默认编码 | 编码 | MIME 类型不被识别时返回的编码 . |

#### 回返

| 返回类型 | 说明 |
| --- | --- |
| 编码 | 相应的编码enum值,或者默认的Encoding(如果不被识别的话). |

### 转到查询串

**至查询(rawQuery?,flags?):\[字符串\](https://developer.mozila.org/en-US/docs/Glossary/String)**

将查询参数的对象转换为 URL 查询字符串.

#### 参数

| 名称 | 类型 | 说明 |
| --- | --- | --- |
| 原始查询 | 查询ParamsType | 包含查询参数的对象. |
| 旗帜 | [参数](https://npmcn.com/package/%40dynatrace-sdk/shared-client-utils/#readme-parametersflags) | 用于控制参数格式化的旗帜(如爆炸阵列). |

#### 回返

| 说明 |
| --- |
| 由此产生的查询字符串 . |

### 从FormData转换

**从FormData( formData, fields) 转换: T**

将数据和字段定义转换成打字对象,为JSON字段应用转换.

#### 参数

| 名称 | 类型 | 说明 |
| --- | --- | --- |
| 窗体数据\*必须 | 格式数据响应Body | 要转换的窗体数据 . |
| 字段\*必须 | 记录 <[字符串](https://developer.mozilla.org/en-US/docs/Glossary/String) \* 表格数据回复字段定义 > | 窗体数据的字段定义. |

#### 回返

| 返回类型 | 说明 |
| --- | --- |
| T级 | 生成的已键入对象 . |

### 转换请求

**变换请求( 对象, 规则): T**

在请求中发送前应用转换规则来转换对象.

#### 参数

| 名称 | 类型 | 说明 |
| --- | --- | --- |
| 对象\*必须 | T级 | 变相对象. |
| 规则\*必须 | 变形规则Param | 改造规则适用. |

#### 回返

| 返回类型 | 说明 |
| --- | --- |
| T级 | 变相对象. |

### 变换响应

**变换响应( 对象, 规则): T**

在一个响应中接收后,通过应用转换规则来转换对象.

#### 参数

| 名称 | 类型 | 说明 |
| --- | --- | --- |
| 对象\*必须 | T级 | 变相对象. |
| 规则\*必须 | 变形规则Param | 改造规则适用. |

#### 回返

| 返回类型 | 说明 |
| --- | --- |
| T级 | 变相对象. |

### 转换到格式数据

**转换 ToFormData( 值, 字段): FormData RequestBody**

使用字段定义将对象转换为FormData RequestBody.

#### 参数

| 名称 | 类型 | 说明 |
| --- | --- | --- |
| 价值\*必须 | T级 | 要转换的对象 . |
| 字段\*必须 | 矩阵 <[格式数据请求字段定义](https://npmcn.com/package/%40dynatrace-sdk/shared-client-utils/#readme-formdatarequestfielddefinition)\> 翻译: | 窗体数据的字段定义. |

#### 回返

| 返回类型 | 说明 |
| --- | --- |
| 格式数据请求 | 由此而来的形式数据正文. |

### 转换到格式数据字段

**转换 ToFormData 字段( 值, 字段): FormData 请求字段 QQ 无效**

根据字段定义将一个值转换为FormDataRequest Field.

#### 参数

| 名称 | 类型 | 说明 |
| --- | --- | --- |
| 价值\*必须 | T级 | 要转换的值 . |
| 字段\*必须 | [格式数据请求字段定义](https://npmcn.com/package/%40dynatrace-sdk/shared-client-utils/#readme-formdatarequestfielddefinition) | 战地定义. |

#### 回返

| 返回类型 | 说明 |
| --- | --- |
| 窗体数据请求字段 {} 无效 | 生成的窗体数据字段,如果没有需要和未定义,则无效. |

## 接口

### Apiclient 选项

API 客户端配置 .

#### 属性

| 名称 | 类型 |
| --- | --- |
| 转换数据\*必须 | [布尔](https://developer.mozilla.org/en-US/docs/Glossary/Boolean) |

### 格式数据请求字段定义

#### 属性

| 名称 | 类型 |
| --- | --- |
| 键\*必须 | [字符串](https://developer.mozilla.org/en-US/docs/Glossary/String) |
| 所需经费\*必须 | [布尔](https://developer.mozilla.org/en-US/docs/Glossary/Boolean) |
| 类型\*必须 | "文字""json""二进制" |

### 窗体数据响应

#### 属性

| 名称 | 类型 |
| --- | --- |
| 类型\*必须 | "文字""二进制" |

### 格式数据响应Json 字段定义

#### 属性

| 名称 | 类型 |
| --- | --- |
| 转换\*必须 | 矩阵 <[字符串](https://developer.mozilla.org/en-US/docs/Glossary/String) | > |
| 类型\*必须 | 贾生 |

### 参数

#### 属性

| 名称 | 类型 |
| --- | --- |
| 爆炸 | 记录 <[字符串](https://developer.mozilla.org/en-US/docs/Glossary/String) | [布尔](https://developer.mozilla.org/en-US/docs/Glossary/Boolean)\> 翻译: |

## 常见问题

### @dynatrace-sdk/shared-client-utils 是什么？

---标题:"@dynatrace-sdk/shared-client-utils"描述: ---注意：该包已被作者标记为弃用——Deprecated

### 如何安装 @dynatrace-sdk/shared-client-utils？

在项目目录运行 npm install @dynatrace-sdk/shared-client-utils，或使用 pnpm add / yarn add / bun add。

### @dynatrace-sdk/shared-client-utils 支持 TypeScript 吗？

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

### @dynatrace-sdk/shared-client-utils 支持 ESM 还是 CommonJS？

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

### @dynatrace-sdk/shared-client-utils 可以商用吗？

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

### @dynatrace-sdk/shared-client-utils 的下载量有多少？

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

### @dynatrace-sdk/shared-client-utils 还在维护吗？

最新版本 1\.0\.1 发布于 2025/07/15（1\.3 年前）；至今共发布 2 个版本，其中过去 12 个月发布了 0 个；首次发布于 2025/07/15。作者已将其标记为弃用，新项目建议寻找替代方案。