如果JavaScript库使用过时的注释?(Should javascript libraries

2019-08-07 02:53发布

显然,这是给开发商何时弃用以及何时删除,但我不知道如何来警告开发人员的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 确实有,我已经忽略了一个弃用的注释? 是否有更好或更常见的方式做到这一点?

Answer 1:

console.log('This function is deprecated.');

这是jQuery的迁移(为1.8 - > 1.9的升级)如何帮助人们提升他们的代码。

从他们的维基 :

为了使开发人员能够迁移旧的jQuery代码时识别和解决兼容性问题,插件开发(未压缩)版本生成的任何时候它的功能被称为控制台的警告消息。 该消息仅在控制台为每个唯一的消息就出现一次。



Answer 2:

基本上有没有弃用的方法/函数的方式 。 它是由开发商办理过时的成员。

我想唯一的事情都有可能做的是做记录了最好的努力,被废弃的函数/方法,并使用@deprecated的源代码文件内标签。

于是,一些编译器(谷歌关闭编译器这样做,如果我没看错)和先进的IDE,可以使用这个标签来验证编译源代码和火灾警告,如果使用一些过时的功能。



文章来源: Should javascript libraries use the deprecated annotation?