【发布时间】:2010-10-28 00:38:05
【问题描述】:
我在使用 jQuery-1.4.3 externs 文件时特别看到了这一点。其 javadocs 内容为
/**
* @param {(string|number|function(number,number))=} arg1
* @return {(number|jQueryObject)}
* @nosideeffects
*/
jQueryObject.prototype.width = function(arg1) {};
我的电话如下所示:
var w = $(window).width();
$('#whatever').width(w)
关闭抱怨: 警告 - jQueryObject.prototype.height 的实际参数 1 与形式参数不匹配 找到 : (jQueryObject|null|number) 必需:(函数(数字,数字):?|数字|字符串|未定义) $('#Xobni').height($(window).height());
通过玩弄(删除可能的返回类型),我可以看到问题是对 width 的第一次调用可能返回一个 jQueryObject,并且由于这不是有效的输入,所以 Closure 给了我一个错误。我试着添加这个:
/**
* @type {number}
*/
var w = $(window).width();
$('#Xobni').width(w);
但随后 Closure 抱怨: 警告 - 初始化变量 找到 : (jQueryObject|null|number) 必填:数字 var w = $(window).width();
问题是当width接受一个参数时,它返回一个jQueryObject。当它不带参数时,它返回一个数字。所以我知道我的电话没问题,但 javadocs 并没有完全反映这一点,所以 Closure 警告我。有没有办法适当地修复 javadocs 或者告诉 Closure 我知道这个结果将是一个数字。我知道我可能可以抑制错误,但我想知道如何更好地注释这些内容。
感谢您的帮助!
【问题讨论】:
标签: javascript javadoc google-closure google-closure-compiler