[英]Documenting a private constructor with JSDoc
我有一个类,其中可以静态调用各个方法,但会返回一个新的类实例以进行链接,例如:
var builder = ns
.setState('a', 'A')
.setState('b', 'B');
Builder
的定义如下:
/**
* @module Builder
*/
/**
* @class Builder
*/
/**
* @private
*/
function Builder() {
this.state = {
query: {}
};
}
Builder.prototype = {
/**
* @param {string} k - The key
* @param {object} v - The value
* @return {Builder}
*/
setState: function(k, v) {
var that = (this instanceof Builder) ? this : new Builder();
that[k] = v;
return that;
}
// Other properties and methods…
}
Builder
构造函数永远不应该由用户代码显式调用,因此我希望它不会出现在文档中。 然而,所有我曾与JSDoc标签试图组合(例如@private
, @constructs
等)似乎无法从内置文档压制它。
您应该能够使用@ignore
指令来实现此目的。 来自文档:
@ignore
标记表示代码中的符号永远不会出现在文档中。 此标记优先于所有其他标记。
从jsDoc的3.5.0版本开始,您可以在类上使用标记@hideconstructor ,告诉jsDoc
不要将构造函数包含在文档中。
/**
* @class Builder
*
* @hideconstructor
*/
function Builder() {
// implementation
}
声明:本站的技术帖子网页,遵循CC BY-SA 4.0协议,如果您需要转载,请注明本站网址或者原文地址。任何问题请咨询:yoyou2525@163.com.