Question

我试图弄清楚如何使用JSDoc3正确评论它。

/**
 * Module ...
 *
 * @module Cookie
 * @returns {{create, get, remove}}
 */
const cookie = (function () {

    /**
     * Function to create cookie.
     *
     * @param {String} name - The cookie name.
     * @param {String} value - The cookie value.
     * @param {Boolean} elongate - The flag to extend cookie lifetime.
     */
    const create = (name, value, elongate) => {
    ...
    };

    /**
     * Function to get cookie.
     *
     * @param {String} key - The cookie identificatior to get.
     * @returns {*}
     */
    const get = (key) => {
    ...
    };

    /**
     * Function to remove cookie.
     *
     * @param {String} key - The cookie identificator to remove.
     */
    const remove = (key) => {
    ...
    };

    return {
        create: create,
        get: get,
        remove: remove
    }
})();

我这样做，但生成的文档看起来很糟糕。我无法将这部分代码重写为ES6标准。能告诉你吗？

Answer 1

经过一番尝试，ai发现@memberof

您可以像这样使用它：

@memberof module:YourModuleName

不知道它是否正确，但是之后我在模块文档中看到了该方法。页。

如何在JSDoc中记录javascript IIFE模块

1 个答案: