gpt4 book ai didi

javascript - 使用 JSDoc 记录对象中包含的函数

转载 作者:行者123 更新时间:2023-11-28 03:50:14 25 4
gpt4 key购买 nike

我正在寻找一种使用 JSDoc 3 来记录 Javascript 字典中包含的函数的方法。

即使我告诉 JSDoc 有一个带有 @function 的函数,它也没有包含在生成的文档中。

是否有 JSDoc 标签可以提供帮助?或者有比我更方便的方法吗?

谢谢

/**
* @namespace Minitel
*/
var Minitel = Minitel || {}

/**
* @callback actionCallback
* @param {Stream} stream The Minitel Stream to which add the Videotex codes
* @param {Object} data Data object
* @param {?number} offsetX X offset
* @param {?number} offsetY Y offset
*/

/**
* Action callbacks
* @member {Object.<string, actionCallback>}
*/
Minitel.actions = {}

/**
* Handles "content-string" actions. The value should already be ready to be
* sent in the stream.
* @function
*/
Minitel.actions["content-string"] = function(stream, data) {
/* ... */
}

/**
* Handles "content-block" actions. It only supports left, center and right
* alignment.
* @function
*/
Minitel.actions["content-block"] = function(stream, data, offsetX, offsetY) {
/* ... */
}

我使用 jsdoc -p -c jsdoc.json app/*.js library/minitel/*.js 生成文档

这是jsdoc.json:

{
"plugins": ["plugins/markdown"],
"opts": {
"template": "../docdash"
}
}

最佳答案

我不确定(因为 jsdoc 有时并不详细),但看起来 @member 不能有 child 。解决方案可以是使用@namespace

因此您的操作将记录如下:

/**
* Action callbacks
* @namespace
*/

@namespace 的一个问题是您无法为其定义类型。但在这种情况下,即使没有 @function 作为静态方法,所有方法也会被记录。

关于javascript - 使用 JSDoc 记录对象中包含的函数,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/48056928/

25 4 0
Copyright 2021 - 2024 cfsdn All Rights Reserved 蜀ICP备2022000587号
广告合作:1813099741@qq.com 6ren.com