javascript - 使用 JSDoc 在自执行函数中记录对象

Question

所以我有几个像这样工作的对象定义:

(function () {
var parent= constructors.Parent.prototype;

/**
 * Creates an instance of Child.
 * 
 * @constructor
 * @augments Parent
 * @this {Child} 
 * @param {object} settings
 */
var Child= function(settings) {
    constructors.Parent.apply(this, arguments); //calling parent constructor
    //constructor code
}

Child.prototype= new constructors.Parent();

/**
 * Method1
 *
 * @this {Child}
 * @param {string} param1
 * @param {number} param2
 */
Child.prototype.method1= function(param1, param2)  {
    parent.method1.apply(this,arguments); //calls "super"
    //method code
}
constructors.Child= Child;
}());

我这样做是为了只有全局变量是“constructors”，这样我就不必一直说“construtors.Child”。但是 JSDoc3 忽略了我的评论并且在此代码上没有生成任何内容。任何人都知道任何特殊标签来解决这个问题？我不介意 JSDoc 将我的类名显示为“Child”还是“constructors.Child”，两种方式都可以。

Answer 1

在@class/@module/@namespace 前面使用@public见https://github.com/jsdoc3/jsdoc/issues/442