JSDoc中文文档(@use JSDoc)

JSDoc @inheritdoc 标签

目录

概述

@inheritdoc标签指示该标识应继承其父类的文档。在你的JSDoc注释中的任何其它标签都将被忽略。

这个标签是为 Closure Compiler提供了兼容性。默认情况下，如果不给标识符加JSDoc注释，标识符将继承其父级的文档。

@inheritdoc标签的存在意味着@override 标签存在。

示例

下面的例子显示了一个类的描述如何从它的父类继承文档:

示例: 一个类继承自他的父类
/**
 * @classdesc Abstract class representing a network connection.
 * @class
 */
function Connection() {}

/**
 * Open the connection.
 */
Connection.prototype.open = function() {
    // ...
};


/**
 * @classdesc Class representing a socket connection.
 * @class
 * @augments Connection
 */
function Socket() {}

/** @inheritdoc */
Socket.prototype.open = function() {
    // ...
};

省略Socket#open的JSDoc注释，你可以得到同样的结果:

示例: 没有@inheritdoc标签继承文档
/**
 * @classdesc Abstract class representing a network connection.
 * @class
 */
function Connection() {}

/**
 * Open the connection.
 */
Connection.prototype.open = function() {
    // ...
};


/**
 * @classdesc Class representing a socket connection.
 * @class
 * @augments Connection
 */
function Socket() {}

Socket.prototype.open = function() {
    // ...
};

JSDoc @override 标签