函数式注释、文件头部注释

标准函数式注释

/**
 * @method 方法名
 * @for 所属类名
 * @param{参数类型}参数名 参数说明
 * @return {返回值类型} 返回值说明
 */

 

文件头部注释

/**
 * @Description: 描述
 * @Author: 作者名
 * @Date: 创建日期
 * @LastEditTime: 最新修改日期
 * @LastEditors: 最新修改者
 */

常用参数

//具体可以看下面的链接
/**
 * @class
 * @callback
 * @param
 * @argument
 * @constructs
 * @return
 * @returns
 * @author
 * @see
 * @version
 * @requires
 * @throws
 * @exception
 * @link
 * @author
 * @constructor
 * @type
 * @extends
 * @example
 * @private
 * @final
 * @event
 * @global
 * @default
 * @module
 * @todo
 * @fixme
 */

参考链接

jsdoc官网

jsdoc Github