jsdoc3中事件标记的工作示例

Question

有人可以给我一个关于如何正确使用@event标签的例子。

我在这里查看了jsdoc3文档： http://usejsdoc.org/tags-event.html 但我无法让它发挥作用。

我正在使用nodejs，我在MyClass / index.js中有一个模块，它以MyClass的名称导出一个构造函数：

module.exports = MyClass;
myClass = function () { ... };

我尝试添加

/**
 * Snowball event.
 * @event MyClass#snowball
 */

在已编译的文档中，snowball出现在全局事件列表中，但当我点击它时，它会告诉我

The requested URL /{path-to-my-docs}/MyClass.html was not found on this server.

提前致谢。

Answer 1

这很好用：

/**
 * @class
 */
function Blah() {
}

/**
 * @event Blah#something
 * @type {Object}
 * @property {integer} some_field Represents something or other.
 */