函數式注釋、文件頭部注釋

代碼注釋的魅力所在

 

標准函數式注釋

/**
 * @method 方法名
 * @for 所屬類名
 * @param{參數類型}參數名 參數說明
 * @return {返回值類型} 返回值說明
 */

 

文件頭部注釋

/**
 * @Description: In User Settings Edit
 * @Author: your name
 * @Date: 2019-06-05 16:09:00
 * @LastEditTime: 2019-06-05 16:09:00
 * @LastEditors: your name
 */

 常用

// TODO: 待完善

// FIXME: 待優化

/**
 * @class
 * @callback
 * @param
 * @argument
 * @constructs
 * @return
 * @returns
 * @author
 * @see
 * @version
 * @requires
 * @throws
 * @exception
 * @link
 * @author
 * @class
 * @constructor
 * @type
 * @extends
 * @example
 * @private
 * @final
 * @event
 * @global
 * @default
 * @module
 * @todo
 * @fixme
 */

參考鏈接

jsdoc官網

jsdoc Github