JSDoc 中文网

语法

¥Syntax

@hideconstructor

概述

¥Overview

@hideconstructor 标记告诉 JSDoc 生成的文档不应显示类的构造函数。此标签在 JSDoc 3.5.0 及更高版本中可用。

¥The @hideconstructor tag tells JSDoc that the generated documentation should not display the constructor for a class. This tag is available in JSDoc 3.5.0 and later.

对于 ES2015 之前的课程，请将此标签与 @class 或 @constructor 标签 结合使用。

¥For pre-ES2015 classes, use this tag in combination with the @class or @constructor tag.

对于 ES2015 类，请在构造函数的 JSDoc 注释中使用此标记。如果你的类没有显式构造函数，请在该类的 JSDoc 注释中使用此标记。

¥For ES2015 classes, use this tag in the JSDoc comment for your constructor. If your class does not have an explicit constructor, use this tag in the JSDoc comment for the class.

示例

¥Examples

@hideconstructor tag with pre-ES2015 class
/**

 * @classdesc Toaster singleton.

 * @class

 * @hideconstructor
 */
var Toaster = (function() {
    var instance = null;

    function Toaster() {}

    /**

     * Toast an item.

     *      * @alias toast

     * @memberof Toaster

     * @instance

     * @param {BreadyThing} item - The item to toast.

     * @return {Toast} A toasted bready thing.
     */
    Toaster.prototype.toast = function(item) {};

    return {
        /**

         * Get the Toaster instance.

         *          * @alias Toaster.getInstance

         * @returns {Toaster} The Toaster instance.
         */
        getInstance: function() {
            if (instance === null) {
                instance = new Toaster();
                delete instance.constructor;
            }

            return instance;
        }
    };
})();
@hideconstructor tag with ES2015 class
/**

 * Waffle iron singleton.
 */
class WaffleIron {
    #instance = null;

    /**

     * Create the waffle iron.

     *      * @hideconstructor
     */
    constructor() {
        if (#instance) {
            return #instance;
        }

        /**

         * Cook a waffle.

         *          * @param {Batter} batter - The waffle batter.

         * @return {Waffle} The cooked waffle.
         */
        this.cook = function(batter) {};

        this.#instance = this;
    }

    /**

     * Get the WaffleIron instance.

     *      * @return {WaffleIron} The WaffleIron instance.
     */
    getInstance() {
        return new WaffleIron();
    }
}