带有导出对象的 JSDoc CommonJS 传递到 IIFE

Question

更新：@speibus 帮助我得出结论，这可能是 JSDoc 本身的问题。我在他们的 GitHub 上将我的发现添加到 this open issue。 @spenibus 找到了解决方案，但它需要稍微改动的 IIFE 版本

我在 CommonJS 模块中使用 IIFE 以便能够与 CommonJS 一起工作，并且如果 module.exports 不存在，则回退到将接口分配给窗口对象。如何正确记录这一点，以便将传入的导出对象视为 module.exports？

/**
 * This is a description
 * @module someModule
 */
(function (exports) {

    /**
     * Returns true if something.
     * @param {String} type
     * @returns {boolean}
     * @static
     */
    var isSomething = function isSomething(type){
        return true;
    };

    exports.isSomething = isSomething;

})(
    //if exports exists, this is a node.js environment so attach public interface to the `exports` object
    //otherwise, fallback to attaching public interface to the `window` object
    (typeof exports === 'undefined') ?
         window
        : exports
);

Answer 1

虽然JSDoc issue 456 似乎相关，但我们还没有到任何地方。

我查看了Use JSDoc: @alias，虽然很有希望，但它并没有提供相同的 JSDoc 输出。

然后我尝试了一些简单的方法，让我在脑海中播放 FF7 的胜利主题，也就是成功了：

/**
 * This is a description
 * @module someModule
 */

(function() {

    // export to window when not used as a module
    if(typeof exports === 'undefined') {
        var exports = window;
    }

    /**
     * Returns true if something.
     * @param {String} type
     * @returns {boolean}
     * @static
     */
    exports.isSomething = function(type){
        return true;
    };
})();

在项目目录上使用jsdoc ./ 会产生与我没有使用 IIFE 相同的输出。基本思想是始终拥有一个名为 exports 的对象并简单地修改它所引用的内容。

Nodejs 测试

var mm = require('./module.js');

console.log('--Testing nodejs--');
console.log(mm);

输出：

--Testing nodejs--
{ isSomething: [Function] }

HTML脚本测试

<script src="module.js"></script>
<script>
    console.log('--html script test--');
    console.log(isSomething.toString());
</script>

输出：

"--html script test--"
"function (type){
    return true;
}"

更新 2015-08-13 05:10 +0000
移动了 IIFE 中的窗口导出，以避免在 html 脚本中出现额外的 exports var。