我正在尝试为JSDoc创建一个插件。 我正在关注文档(具有讽刺意味的是,缺乏这些文档),我不知道该怎么做。
我的插件已正确加载,我正在尝试一个简单的示例。这是我的插件(加载,因为我可以从那里抛出一个错误来阻止jsdoc运行):
visitNode: function(node, e, parser, currentSourceName) {
if(node.type === 109){
if(!e.comment || e.comment ==="@undocumented"){
var startComment = '/**',
endComment = '\n*/';
var params = node.getParams(),
paramsComment = '';
for(var i=0; i<params.length; i++){
paramsComment += '\n* @param ' + params[i];
}
e.comment = startComment +
paramsComment +
endComment;
}
}
请注意,node.type === 109等同于Token.FUNCTION,它应该按照示例here提供,但插件中的标识未定义。
如果您知道一个更好的网站,它解释了如何编写JSDoc插件,那么非常感谢...谢谢
答案 0 :(得分:2)
我也有这个问题,似乎很奇怪,JSDoc没有某种已经制作的选项,或者至少是一个插件。
无论如何创建这个插件已经解决了我的问题。我正在使用JSDoc版本3.4:
'use strict';
exports.handlers = {
symbolFound:function(e) {
if(e.astnode.type === "FunctionDeclaration" ) {
if( (e.comment==="@undocumented")){
e.comment = '/** undocumented */';
}
}
}
};