jsdoc没有';t trust@param声明

jsdoc没有';t trust@param声明,jsdoc,Jsdoc,在如下代码上运行jsdoc时,@param docs被忽略。我假设这是因为我在IIFE中返回函数,但考虑到JS中的模式有多普遍,我很难相信jsdoc不能处理它 /** @namespace */ var util = { /** * Repeat <tt>str</tt> several times. * @param {google.maps.Marker} str The string to repeat. * @param {n

在如下代码上运行jsdoc时,@param docs被忽略。我假设这是因为我在IIFE中返回函数,但考虑到JS中的模式有多普遍,我很难相信jsdoc不能处理它

/** @namespace */
var util = {
    /**
     * Repeat <tt>str</tt> several times.
     * @param {google.maps.Marker} str The string to repeat.
     * @param {number} [times=1] How many times to repeat the string.
     * @returns {string}
     */
    repeat: (function() {

        var magicNumber = 1;

        return function(str, times) {
            if (times === undefined || times < magicNumber) {
                times = magicNumber;
            }
            return new Array(times+1).join(str);
        };

    }())
};
/**@名称空间*/
var util={
/**
*重复str数次。
*@param{google.maps.Marker}str要重复的字符串。
*@param{number}[times=1]重复该字符串多少次。
*@返回{string}
*/
重复:(函数(){
var magicNumber=1;
返回函数(str,times){
if(times==未定义的| | times
显然,如果jsdoc认为记录的项目是一项功能,那么它只会包括
@param
@return
文档。您可以通过在文档注释中指定来强制执行此行为

因此,这起了作用:

/** @namespace */
var util = {
    /**
     * Repeat <tt>str</tt> several times.
     * @function <---- ADDED THIS LINE
     * @param {google.maps.Marker} str The string to repeat.
     * @param {number} [times=1] How many times to repeat the string.
     * @returns {string}
     */
    repeat: (function() {

        var magicNumber = 1;

        return function(str, times) {
            if (times === undefined || times < magicNumber) {
                times = magicNumber;
            }
            return new Array(times+1).join(str);
        };

    }())
};
/**@名称空间*/
var util={
/**
*重复str数次。
*@函数