原文:在 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