原文:在 TypeScript 中使用 JSDoc 为函数的多个对象参数写注释

最近在将一个使用 JavaScript 写的 npm 包重构成 TypeScript。重构完后,发现原先的 JSDoc 注释在 ts 文件编译后失效了,便搜索了一下,但是谷歌并没有找到我所想要的答案,便只能自己研究了。这篇算是记录一下研究结果。 首先说明一下 JSDoc 的函数参数注释写法:在函数上方,内容放置于多行注释内,下面是一个基础的例子,详细内容请参考 Use JSDoc: param 至 ...

2021-09-18 16:29 0 116 推荐指数:

查看详情

Python中使用PyCharm为函数参数增加注释

函数名中键入数遍光标,左上角亮起小灯泡,点击小灯泡 选中第二行内容 在"""后添加函数注释,以及参数注释 然后再引用函数时,选中函数,Ctrl q 即可显示函数以及参数注释了 ...

Tue Apr 16 00:52:00 CST 2019 0 6392
TypeScript 学习笔记-JSDoc

使用JSDoc /**基础类型*/ /** @type {string} */ /**联合类型 */ /** @type {string | number ...

Fri Oct 12 03:29:00 CST 2018 0 784
JSDoc 注释规范

什么是 JSDoc JSDoc 是一个根据 JavaScript 文件中注释信息,生成 JavaScript 应用程序或模块的API文档的工具。你可以使用 JSDoc 标记如:命名空间,类,方法,方法参数等。从而使开发者能够轻易地阅读代码,掌握代码定义的类和其属性和方法,从而降低维护 ...

Fri Jan 01 00:18:00 CST 2021 0 349
jsdoc — js注释

官方文档 http://usejsdoc.org/ - sublime插件 https://github.com/spadgos/sublime-jsdocs - 生成文档 生成html: (1)安装:npm install jsdoc -g (2)执行:jsdoc test.js ...

Tue Jul 19 00:57:00 CST 2016 0 1712
JSDoc 注释规范

命令名描述@param @argument 指定参数名和说明来描述一个函数参数@returns 描述函数的返回值@author 指示代码的作者@deprecated 指示一个函数已经废弃,而且在将来的代码版本中将彻底删除。要避免使用这段代码@see 创建一个HTML链接,指向指定类的描述 ...

Sat Mar 10 22:26:00 CST 2012 0 5145
JSDoc 注释规范(转)

什么是 JSDoc JSDoc 是一个根据 JavaScript 文件中注释信息,生成 JavaScript 应用程序或模块的API文档的工具。你可以使用 JSDoc 标记如:命名空间,类,方法,方法参数等。从而使开发者能够轻易地阅读代码,掌握代码定义的类和其属性和方法,从而降低维护成本,和提高 ...

Fri Jul 14 01:45:00 CST 2017 0 1500
JSDoc 注释规范

命令名描述 @param @argument 指定参数名和说明来描述一个函数参数@returns 描述函数的返回值@author 指示代码的作者@deprecated 指示一个函数已经废弃,而且在将来的代码版本中将彻底删除。要避免使用这段代码@see 创建一个HTML链接,指向指定类的描述 ...

Sat May 26 01:14:00 CST 2018 0 8931
JSDoc参考注释模板

@import url(http://www.cnblogs.com/Load.ashx?type=style&file=SyntaxHighlighter.css); @import url(/css/cuteeditor.css); 1. 注释宏或者常量 ...

Mon Jun 11 22:39:00 CST 2012 0 6082
 
粤ICP备18138465号  © 2018-2025 CODEPRJ.COM