Eclipse JSDT - 声明函数参数的类型

时间:2011-07-10 20:23:19

标签: eclipse eclipse-3.6 jsdoc

使用Eclipse Helios:

如果我定义一个简单的Javascript函数

/**
 * @returns {Number}
 * @param {String} arg 
 */
function test(arg) 
{
     return 1;
}
  • 标签是由Alt-Shift0J自动添加的标签 - 然后该功能的推断类型为:
Number test(any arg)

Parameters:
{String} arg
@returns
{Number}

注意“any arg”,尽管Eclipse也在后面识别参数是“{String} arg”。

我没有尝试过将arg的推断类型设置为“any”以外的任何其他类型。这意味着没有检测到使用非String调用该函数,这是一个遗憾。

那么,这是一个错误吗?不应该工作?我做错了什么?

1 个答案:

答案 0 :(得分:-1)

实际上JSDT / Eclipse中的JsDoc注释主要有两个原因(根据我的理解,如果它不相同,请纠正我)

  1. 用于生成文档和
  2. 让eclipse-JSDT引擎通过自动建议(特定于案例)帮助开发人员。

    所以eclipse-developers不仅仅是在你运行js文件时用你的实际代码实现来交叉检查注释绑定。而且,当你运行javascript时。在运行时,javadoc注释被忽略为仅仅是注释。