概述
@override
标签表示一个符号覆盖了父类中具有相同名称的符号。
此标签是为了与 Closure Compiler 兼容而提供的。默认情况下,JSDoc 会自动识别覆盖父类的符号。
如果 JSDoc 注释包含 @inheritdoc
标签,则无需包含 @override
标签。@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() {}
/**
* Open the socket.
* @override
*/
Socket.prototype.open = function() {
// ...
};