显然,这是给开发商何时弃用以及何时删除,但我不知道如何来警告开发人员的JavaScript函数已弃用?
一些流行的语言( Java的 , C# , Python中以某种形式)支持的语言水平弃用。
对于JavaScript,虽然,我找不到任何标准的方式,开发人员可以指示功能已被否决(代码)。 我能做的最好的就是按照(大量的)发行说明。
作为一个例子,grepping的jQuery 1.8的全部源代码显示最小直列评论:
# curl http://code.jquery.com/jquery-1.8.0.js | grep -i depre
// jQuery.support.boxModel DEPRECATED in 1.8 since we don't support Quirks Mode
// *** attrChange attrName relatedNode srcElement are not normalized, non-W3C, deprecated, will be removed in 1.8 ***
// Some plugins are using, but it's undocumented/deprecated and will be removed.
// Deprecated
// Limit scope pollution from any deprecated API
// Deprecated, use jQuery.browser.webkit instead
W3C和MDN似乎并不有一个标准的方式或提供关于如何处理这个建议。
我发现最好的是JSDoc的@deprecated
标签。
有谁知道的JavaScript 确实有,我已经忽略了一个弃用的注释? 是否有更好或更常见的方式做到这一点?