跳到主要内容

@hideconstructor

语法

@hideconstructor

概述

@hideconstructor 标记告诉 JSDoc 生成的文档不应该显示类的构造函数。JSDoc 3.5.0 及更高版本中提供了此标记。

对于 ES2015 之前的类,请将此标记与 @class@constructor标记结合使用。

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

实例

ES2015 之前的类带有 @hideconstructor:

/**
* @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;
}
};
})();

ES2015 类带有 @hideconstructor:

/**
* Waffle iron singleton.
*/
class WaffleIron {
// Private field declarations
#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();
}
}

相关链接