Swagger 客户端 <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/ec1bf85a-79da-430f-97cf-758f66bb1cca.png" height="50" align="right">

Swagger 客户端是一个 JavaScript 模块，允许您获取、解析和与 Swagger/OpenAPI 文档交互。

新消息！

**这是 swagger-js 的新版本，3.x。**新版本支持 Swagger 2.0 以及 OpenAPI 3。

想了解更多？查看我们的常见问题。

关于 3.x 已知缺失的功能，请参阅废弃功能列表。

有关 swagger-js 的旧版本，请参考 2.x 分支。

npm 包名为 swagger-client，而 GitHub 仓库名为 swagger-js。 我们很快会统一这一点。只是提前通知您。您可能会看到两个名称的引用。

兼容性

OpenAPI 规范自 2010 年创建以来经历了多次修订。 Swagger 客户端与 OpenAPI 规范的兼容性如下：

文档

使用

• 安装
• 标签接口
• OAS 操作的 HTTP 客户端
• OpenAPI 定义解析器
• HTTP 客户端
• Swagger 客户端 API

开发

• 贡献
• 设置
• 脚本

迁移

• 迁移指南
• 废弃功能列表

运行时

Node.js

swagger-client 需要 Node.js >=12.20.0，并根据 Node.js 版本使用不同的 fetch 实现。

• >=12.20.0 <18 - node-fetch@3
• >=18 - 原生 Node.js fetch

注意：swagger-client 的最低 Node.js 运行时版本与 Node.js 发布保持一致， 这意味着我们可以在不进行主要版本升级的情况下停止支持已达到生命周期结束（EOL）的 Node.js 版本。

浏览器

swagger-client 适用于最新版本的 Chrome、Safari、Firefox 和 Edge 浏览器， 并使用每个支持的浏览器提供的原生 fetch 实现。

安全联系方式

请通过电子邮件 security@swagger.io 披露任何与安全相关的问题或漏洞，而不要使用公共问题跟踪器。