什么是 jsdoc
jsdoc 是一个根据 javascript 文件中注释信息，生成 javascript 应用程序或模块的api文档的工具。你可以使用 jsdoc 标记如：命名空间，类，方法，方法参数等。从而使开发者能够轻易地阅读代码，掌握代码定义的类和其属性和方法，从而降低维护成本，和提高开发效率。
jsdoc 注释规则
jsdoc注释一般应该放置在方法或函数声明之前，它必须以/ **开始，以便由jsdoc解析器识别。其他任何以 /* ， /*** 或者超过3个星号的注释，都将被jsdoc解析器忽略。如下所示：
/***一段简单的 jsdoc 注释。*/
jsdoc 的注释效果
假如我们有一段这样的代码，没有任何注释，看起来是不是有一定的成本。
functionbook(title, author){ this.title=title; this.author=author;}book.prototype={ gettitle:function(){ returnthis.title; },setpagenum:function(pagenum){ this.pagenum=pagenum; }};
如果使用了 jsdoc 注释该代码后，代码的可阅读性就大大的提高了。
/*** book类，代表一个书本.* @constructor* @param {string} title - 书本的标题.* @param {string} author - 书本的作者.*/functionbook(title, author){ this.title=title; this.author=author;}book.prototype={/*** 获取书本的标题* @returns {string|*} 返回当前的书本名称*/gettitle:function(){ returnthis.title; },/*** 设置书本的页数* @param pagenum {number} 页数*/setpagenum:function(pagenum){ this.pagenum=pagenum; }};
@constructor 构造函数声明注释
@constructor明确一个函数是某个类的构造函数。
@param 参数注释
我们通常会使用@param来表示函数、类的方法的参数，@param是jsdoc中最常用的注释标签。参数标签可表示一个参数的参数名、参数类型和参数描述的注释。如下所示：
/*** @param {string} wording 需要说的句子*/functionsay(wording){ console.log(wording);}
@return 返回值注释
@return表示一个函数的返回值，如果函数没有显示指定返回值可不写。如下所示：
/** @return {number} 返回值描述*/
@example 示例注释
@example通常用于表示示例代码,通常示例的代码会另起一行编写，如下所示：
/** @example* multiply(3, 2);*/
其他常用注释
@overview对当前代码文件的描述。
@copyright代码的版权信息。
@author []代码的作者信息。
@version当前代码的版本。
以上就是jsdoc是什么？jsdoc注释规范的介绍的详细内容。