显然,由开发人员决定何时弃用以及何时删除,但我想知道如何警告开发人员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
Run Code Online (Sandbox Code Playgroud)
W3C和MDN似乎没有标准方法或提供有关如何处理此问题的建议.
我发现的最好的是JSDoc的@deprecated标签. …
我有两个功能:Method(A val)和Method(B val),一个了结val型A和其他类型的B.
我想标记Method(A val)过时,以便IDE可以突出显示它已经过时的事实.
我已经装饰了方法[Obsolete],但是,我没有看到它被弃用.
我错过了什么吗?从我的研究中,我只看到了创建一个全新方法来替换旧方法的例子,但没有看到任何一个重载函数的例子取代了旧的已弃用的方法.任何帮助将受到高度赞赏.