js注释规范
@param @argument 指定参数名和说明来描述⼀个函数参数
@returns 描述函数的返回值
@author 指⽰代码的作者
@deprecated 指⽰⼀个函数已经废弃,⽽且在将来的代码版本中将彻底删除。要避免使⽤这段代码
@see 创建⼀个HTML链接,指向指定类的描述
@version 指定发布版本
@requires 创建⼀个HTML链接,指向这个类所需的指定类
@throws @exception 描述函数可能抛出的异常的类型
{@link}创建⼀个HTML链接,指向指定的类。这与@see很类似,但{@link}能嵌在注释⽂本中
@fileoverview 这是⼀个特殊的标记。如果在⽂件的第⼀个⽂档块中使⽤这个标记,则指定该⽂档块的余下部分将⽤来提供这个⽂件的概述 @class提供类的有关信息,⽤在构造函数的⽂档中
@constructor 明确⼀个函数是某个类的构造函数
@type 指定函数的返回类型
@extends指⽰⼀个类派⽣了另⼀个类。JSDoc通常⾃⼰就可以检测出这种信息,不过,在某些情况下则必须使⽤这个标记
javascript说明@private指⽰⼀个类或函数是私有的。私有类和函数不会出现在HTML⽂档中,除⾮运⾏JSDoc时提供了–private命令⾏选项
@final 指⽰⼀个值是常量值。要记住JavaScript⽆法真正保证⼀个值是常量
@ignore JSDoc忽略有这个标记的函数
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论