# @benasher44/wsdl-tsclient 中文文档

规范地址：https://npmcn.com/package/%40benasher44/wsdl-tsclient/

版本：1\.4\.0
npm 元数据更新时间：2023-09-14T21:28:18.975Z
中文译文更新时间：2026-11-07T21:55:51.992Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：209 kB，54 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=10\.0\.0
- 运行依赖：11 个
- 首次发布：2023-09-14T21:28:18.214Z
- 最新版本发布：2023-09-14T21:28:18.622Z
- 近 30 天下载量：5897（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：1（近 12 个月 0 个）

## 中文简介

由 WSDL 文件生成打字机肥皂客户端,并使用打字机去finitons.

## 安装

```sh
npm install @benasher44/wsdl-tsclient
```

也可以使用：`pnpm add @benasher44/wsdl-tsclient`、`yarn add @benasher44/wsdl-tsclient`、`bun add @benasher44/wsdl-tsclient`

## README

# WSDL TS 客户端

[![travis-status](https://travis-ci.org/dderevjanik/wsdl-tsclient.svg?branch=master)](https://travis-ci.org/dderevjanik/wsdl-tsclient) ![license](https://img.shields.io/npm/l/wsdl-tsclient) [![Known Vulnerabilities](https://snyk.io/test/github/dderevjanik/wsdl-tsclient/badge.svg)](https://snyk.io/test/github/dderevjanik/wsdl-tsclient) [![npm-version](https://img.shields.io/npm/v/wsdl-tsclient)](https://npmjs.com/package/wsdl-tsclient)

**如何生成和使用 wsdl- tsclient 示例 :** [wsdl-ts客户端实例](https://github.com/dderevjanik/wsdl-tsclient-example)

生成 a [肥皂客户端](https://www.npmjs.com/package/soap) 带有 WSDL 文件的打字符定义.

此库使用 [ts-形态](https://www.npmjs.com/package/ts-morph) 生成打字符代码和 [肥皂](https://github.com/vpulim/node-soap) 为运行时间。 有爪哇的灵感 [导入](https://docs.oracle.com/javase/8/docs/technotes/tools/unix/wsimport.html) 财务报告和审定财务报表 [openapi 生成器](https://github.com/OpenAPITools/openapi-generator)。 。 。 .

_注:_ 添加 [肥皂](https://www.npmjs.com/package/soap) 到您 npm 运行时间依赖关系( t)`npm i soap`) (中文(简体) ).

## 安装

```sh
npm i wsdl-tsclient
```

或安装到 `-g` \* 在全球提供国家综合倡议.

```sh
npm i -g wsdl-tsclient
```

## 使用量

您可以检查示例库 [wsdl-ts客户端实例](https://github.com/dderevjanik/wsdl-tsclient-example)

### 使用 CLI 生成客户端

最容易从中生成客户端的方法是使用CLI. 您只需提供路径到 `.wsdl` 文档和 输出目录的路径( e)`-o` (第1款)。 如果您想要生成 **只有打字符类型** (没有运行时间代码) 对于节点肥皂,你可以通过 `--emitDefinitionsOnly` 一、导 言.

`wsdl-tsclient ./soap.wsdl -o ./generated`

`wsdl-tsclient ./resources/**/*.wsdl -o ./generated` - 使用光彩

您也可以使用 `npx`

`npx wsdl-tsclient ./soap.wsdl -o ./generated`

```bash
wsdl-tsclient [options] [path]

Options:
      --help                        Show help                          [boolean]
  -v, --version                                                        [boolean]
  -o                                Output directory         [string] [required]
      --emitDefinitionsOnly         Generate only Definitions          [boolean]
      --modelNamePreffix            Prefix for generated interface names[string]
      --modelNameSuffix             Suffix for generated interface names[string]
      --caseInsensitiveNames        Case-insensitive name while parsing
                                    definition names                   [boolean]
      --maxRecursiveDefinitionName  Maximum count of definition's with same name
                                    but increased suffix. Will throw an error if
                                    exceed                              [number]
      --quiet                       Suppress all logs                  [boolean]
      --verbose                     Print verbose logs                 [boolean]
      --no-color                    Logs without colors                [boolean]

Examples:
    wsdl-tsclient file.wsdl -o ./generated/
    wsdl-tsclient ./res/**/*.wsdl -o ./generated/
```

### 程序生成客户端

```typescript
import { generateClient } from "wsdl-tsclient";

parseAndGenerate("./path/to/MyWsdl.wsdl", "./generated/");
```

### 在您的工程中使用生成的客户端

_说明:_ 确保你有 [肥皂](https://www.npmjs.com/package/soap) 在运行时间依赖性中设置软件包`npm i soap`(中文(简体) )

```typescript
import { createClientAsync } from "./generated/MyWsdl";

const client = await createClientAsync("./path/to/wsdl.wsdl");
client.CallSoapMethodAsync();
```

设置基本认证

```typescript
import soap from "soap";
import { createClientAsync } from "./generated/MyWsdl";

const client = await createClientAsync("./path/to/wsdl.wsdl");

const basicAuth = new soap.BasicAuthSecurity(auth.username, auth.password);
client.setSecurity(basicAuth);

client.CallSoapMethodAsync();
```

更多信息,请访问 [肥皂](https://github.com/vpulim/node-soap)

## 如何运作

![overview](https://npmcn.com/package/%40benasher44/wsdl-tsclient/docs/Overview.png)

## 许可证

源代码根据 [麻省理工学院](https://npmcn.com/package/%40benasher44/wsdl-tsclient/LICENSE) 许可证

## 贡献者

![Contributors](https://contrib.rocks/image?repo=dderevjanik/wsdl-tsclient)

## 常见问题

### @benasher44/wsdl-tsclient 是什么？

由 WSDL 文件生成打字机肥皂客户端,并使用打字机去finitons\.

### 如何安装 @benasher44/wsdl-tsclient？

在项目目录运行 npm install @benasher44/wsdl-tsclient，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 wsdl-tsclient，可以用 npx wsdl-tsclient 直接运行。

### @benasher44/wsdl-tsclient 支持 TypeScript 吗？

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

### @benasher44/wsdl-tsclient 支持 ESM 还是 CommonJS？

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

### @benasher44/wsdl-tsclient 需要什么版本的 Node\.js？

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

### @benasher44/wsdl-tsclient 可以商用吗？

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

### @benasher44/wsdl-tsclient 的下载量有多少？

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

### @benasher44/wsdl-tsclient 还在维护吗？

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