如果你是一个前端开发人员，你肯定会用到很多工具和框架来加速你的工作进程。其中一个很受欢迎的工具是 swagger-injector-fork npm 包，它可以帮助你快速地生成基于 OpenAPI 文档的 API 调用。
什么是 swagger-injector-fork？
swagger-injector-fork 是一个基于 Node.js 的 npm 包，它将 swagger 文档转换成可执行的 JavaScript 代码。它可以帮助你快速地生成基于 OpenAPI 文档的 API 调用。
swagger-injector-fork 还具有以下特性：
- 支持自定义 HTTP 请求。
- 支持多个文档。
- 支持 JavaScript 和 TypeScript。
开始使用 swagger-injector-fork
首先，确保你已经安装了 Node.js，然后在命令行中运行以下命令：
npm install swagger-injector-fork --save
在你的代码中导入 swagger-injector-fork：
const swaggerInjector = require('swagger-injector-fork');接下来，你需要加载你的 swagger 文档：
const swaggerDoc = require('./path/to/swagger.json');
const options = {
url: 'http://localhost:3000'
};这里我们将 swagger 文档存储在本地，并设置一个选项以指定要调用的 API 的 URL。
现在，你可以使用 swaggerInjector.generate() 方法来生成可以调用你的 API 的代码：
swaggerInjector.generate(swaggerDoc, options)
.then(code => {
console.log(code);
})
.catch(error => {
console.error(error);
});这个方法返回一个 Promise，其中的 code 参数是生成的代码。你可以将这段代码复制到你的项目中，并使用它来调用你的 API。
自定义 HTTP 请求
swaggerInjector.generate() 方法默认使用 Node.js 的 http 模块来发出请求。但是，你可以通过传递一个叫做 requestFn 的选项来自定义请求的行为。
例如，如果你想使用 axios 来发出请求，你可以这样做：
-- -------------------- ---- -------
----- ----- - -----------------
----- ------- - -
---- ------------------------
---------- --
----
-------
--------
----
-- -- -------
----
-------
--------
----- ----
--
--多个文档
swagger-injector-fork 通过将多个文档合并为一个文档来支持多个文档。要合并多个文档，你需要在 options 中传递一个叫做 documents 的数组。
例如，你可以这样做：
const swaggerDoc1 = require('./path/to/swagger1.json');
const swaggerDoc2 = require('./path/to/swagger2.json');
const options = {
url: 'http://localhost:3000',
documents: [swaggerDoc1, swaggerDoc2]
};支持 JavaScript 和 TypeScript
swagger-injector-fork 支持生成 JavaScript 和 TypeScript。要生成 TypeScript，请确保您的项目中安装了 TypeScript，并将 options 中的 type 属性设置为 'ts'。
const options = {
url: 'http://localhost:3000',
type: 'ts'
};这将生成 TypeScript 代码。
示例代码
以下是一个完整的示例代码的例子：
-- -------------------- ---- -------
----- --------------- - ---------------------------------
----- ----- - -----------------
----- ---------- - ----------------------------------
----- ------- - -
---- ------------------------
---------- --
----
-------
--------
----
-- -- -------
----
-------
--------
----- ----
--
--
------------------------------------ --------
---------- -- -
------------------
--
------------ -- -
---------------------
---总结
swagger-injector-fork 可以帮助你快速地生成基于 OpenAPI 文档的 API 调用。你可以自定义 HTTP 请求，合并多个文档，并选择生成 JavaScript 或 TypeScript 代码。它可以帮助你提高效率，将更多的精力集中在业务逻辑的实现上，是前端开发人员的必备工具之一。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60055cbe81e8991b448da502