在前端开发过程中，我们经常需要从代码中提取注释，以便于生成文档或者做一些自动化操作。此时，npm 包 extract-comments 就能派上用场了。
安装 extract-comments
使用 npm 进行安装：
npm install extract-comments
提取注释
extract-comments 可以提取 JavaScript 代码中的注释，并按照 JSDoc 标准进行解析。下面是一个示例代码片段：
-- -------------------- ---- ------- --- - ---- --- ------- --------- - - ------ -------- - - --- ----- ------ -- ---- - ------ -------- - - --- ------ ------ -- ---- - -------- -------- --- --- -- - --- -- -- -------- ------ -- - ------ - - -- -展开代码
我们可以使用 extract-comments 来提取这个函数定义中的注释：
-- -------------------- ---- ------- ----- ------- - ---------------------------- ----- ---- - ---- - ---- --- ------- --------- - - ------ -------- - - --- ----- ------ -- ---- - ------ -------- - - --- ------ ------ -- ---- - -------- -------- --- --- -- - --- -- -- -------- ------ -- - ------ - - -- --- ----- -------- - -------------- ----------------------展开代码
运行后，会输出以下结果：
-- -------------------- ---- ------- - - -------- ----- --- ------- ----------- ------- - - ------ -------- ------- ---- ------- --------- -------------- ---- ----- ------ -- ----- -- - ------ -------- ------- ---- ------- --------- -------------- ---- ------ ------ -- ----- -- - ------ ---------- ------- --------- -------------- ---- --- -- - --- --- - - - -展开代码
可以看到，extract-comments 将注释解析成了一个对象数组，每个对象包含了这段注释的内容和标签。
进一步解析
extract-comments 提取出来的注释已经按照 JSDoc 标准进行了解析。但如果我们需要对其进行更进一步的解析，例如将它们转化为 Markdown 格式，就需要使用其他工具。
下面是一个示例代码片段，展示如何使用 jsdoc-to-markdown 将注释转换为 Markdown 格式：
-- -------------------- ---- ------- ----- ------- - ---------------------------- ----- -------- - ----------------------------- ----- ---- - ---- - ---- --- ------- --------- - - ------ -------- - - --- ----- ------ -- ---- - ------ -------- - - --- ------ ------ -- ---- - -------- -------- --- --- -- - --- -- -- -------- ------ -- - ------ - - -- --- ----- -------- - -------------- ----- -------- - --------------------- ----- -------- --- ----------------------展开代码
运行后，会输出以下结果：
-- -------------------- ---- ------- -- --------------- --- ------ -- - ------------------- ---- --- ------- --------- --------- ------ -------- - ----- - ---- - ----------- - - --- - --- - --- - - --- - ------------------- - --- ----- ------ -- ---- - - --- - ------------------- - --- ------ ------ -- ---- - ------------ ------------------- - --- --- -- - --- --展开代码
可以看到，我们成功地将注释转化为了 Markdown 格式，并且生成了一个函数的 API 文档。
总结
在本文中，我们介绍了如何使用 npm 包 extract-comments 提取 JavaScript 代码中的注释。通过进一步解析，我们还将注释转化为了 Markdown 格式，并生成了一个函数的 API 文档。这些技术在前端开发中非常有用，希望读者可以从本文中学到一些有用的知识。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/47070
