在前端开发中，jsdoc 是一种十分常见的代码注释工具，可以用于生成 API 文档、自动化测试等。然而，在应用程序中，我们也需要将这些 jsdoc 注释转换为 JSON Schema，以利于数据的管理和使用。这时，我们可以使用 npm 包 esmiley-jsdoc-to-json-schema。
安装
你可以使用以下命令在你的项目中安装 esmiley-jsdoc-to-json-schema：
npm install esmiley-jsdoc-to-json-schema --save-dev
使用
esmiley-jsdoc-to-json-schema 提供了两种方式来转换 jsdoc 注释为 JSON Schema。
CLI
可以通过命令行来使用 esmiley-jsdoc-to-json-schema：
npx esmiley-jsdoc-to-json-schema --input <inputPattern> --output <outputPath>
其中，<inputPattern> 是你想要转换的文件（可以是 glob 模式，比如 src/**/\*.js），<outputPath> 则是你想要输出 JSON Schema 的文件路径。如果未指定 --output，则默认输出到命令行。此命令还提供了一些其他选项，可以通过 npx esmiley-jsdoc-to-json-schema --help 查看详情。
模块
除了命令行，你还可以作为模块引入 esmiley-jsdoc-to-json-schema：
-- -------------------- ---- ------- ----- -- - -------------- ----- ------------ - ---------------------------------------- ----- ----- - ----------- ----- ------ - -------------- ----- ----- - ---------------------- -------- ----- ------ - -------------------- ------------------------ ---------------------- ----- ----
jsdoc2schema 函数接受一个 jsdoc 字符串，返回一个 JSON Schema 对象。你可以根据自己的需要，将其输出到 JSON 文件、存储到数据库等。
示例
我们假设有一个类定义：
-- -------------------- ---- -------
---
- --- ---- ------
- ------ ----
--
----- ---- -
---
- ------ - --- -----
- ------ -------- ---- - --- ---- -- --- -----
- ------ -------- --- - --- --- -- --- -----
--
----------------- ---- -
--------- - -----
-------- - ----
-
---
- --- --- ---- -- --- -----
- -------- -------- - --- ---- -- --- -----
--
--------- -
------ ----------
-
---
- --- --- --- -- --- -----
- -------- -------- - --- --- -- --- -----
--
-------- -
------ ---------
-
-然后，我们可以将其转换为以下 JSON Schema：
-- -------------------- ---- -------
-
------- ---------
------------- -
------- -
------- --------
--
------ -
------- --------
-
--
----------- -
-------
-----
-
-这样，我们就可以根据生成的 JSON Schema 来验证我们的数据是否符合要求，并采取相应的行动。
结语
esmiley-jsdoc-to-json-schema 可以帮助我们更加高效地管理我们的数据，减少了代码出错的概率。因此，它是一个十分有价值的工具，希望这篇文章对你有所帮助。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6005543081e8991b448d185c