jsdoc3 - 具有揭示模块模式的 Jsdoc 命名空间

Question

我试图让命名空间与显示模块模式一起工作。我的代码类似于以下内容：

/**
* @namespace bigpage
*/
var bigpage = {};

/**
* @namespace bigpage.data.methods
* @memberOf bigpage.data
*/

bigpage.data.methods = bigpage.data.methods || (function() {
    /**
    * @function
    * @memberOf bigpage.data.methods
    * @param {string} 
    */
    function getDataSeller(method) {
    }
    return { getDataSeller : getDataSeller };
 })();

但是，JSdoc 没有看到获取 getDataSeller 文档。如果有人可以给我一种方法以及上述方法不起作用的原因，那就太好了。

Answer 1

我发现这个链接非常有帮助： http ://devnull.absolventa.de/2014/03/25/jsdoc-and-the-revealing-module-pattern/

// In file: namespace.js
(function() {
    window.Absolventa = window.Absolventa || {};
}());

// In file: modules/urlify.js
(function() {
    "use strict";
    Absolventa.Urlify = (function() {
        var init;

        /**
         * @param {string} foo
         */
        init = function(foo) {
          // Magick!
        };

        return {
          init : init
        };
    }());
}());

到目前为止，我们已经看到了一些初步的成功。我还没有在我们所有的代码中完全实现它，但我已经在我们最嵌套的代码中使用它并且它似乎正在工作（使用 JSDoc3）