@private
描述: 标记为私有。
语法
使用JSDoc标签字典(默认启用):
@private
使用Closure Compiler标签字典:
@private [{typeExpression}]
概述
@private
标签标记标识符为私有,或者不昨一般用途使用。私有成员不会在生成文档中输出任何内容,除非JSDoc使用 -p/--private
命令行选项运行。在JSDoc3.3.0或更高版本中,您还可以使用 -a/--access
命令行选项来改变这种行为。
@private
标签不被子成员继承。 例如,如果@private标记添加到命名空间,命名空间的成员仍然会输出到生成的文档中;因为命名空间是私有的,成员的 namepath 不包含在命名空间中。
@private
标签和@access private
是等价的。
例子
在下面的例子中,Documents
和Documents.Newspaper
会被输出到生成的文档中,但是Documents.Diary
不会。
例如:
/** @namespace */
var Documents = {
/**
* An ordinary newspaper.
*/
Newspaper: 1,
/**
* My diary.
* @private
*/
Diary: 2
};