为什么grunt的日志记录功能被弃用了?

时间:2014-05-16 04:17:59

标签: javascript node.js logging github gruntjs

通过grunt访问的grunt.log.<method>默认日志记录功能似乎已被弃用。 grunt在GitHub上的repo页面有一个新的存储库,不到两周前首次提交,名为“grunt-legacy-log”,其中“legacy”意味着“旧的,除了向后兼容性之外不再使用”。此外,详细说明这些函数的API的主页http://gruntjs.com/api/grunt.log在页面顶部有一个断开的链接,其目标会产生404错误。

为什么会这样?我通过一个简单的谷歌搜索找到的只有一个GitHub discussion,评论者似乎已经计划好了这一点,但他们所做的一切都没有记录在我能找到的任何其他地方。它们似乎指的是之前的讨论,但它们并没有与之相关联。 grunt的博客说grunt s“日志记录API已被分解为一个单独的模块,grunt-legacy-log,以便于维护”,但它没有扩展这意味着什么。他们为什么要进行维护?为什么它被称为“遗产”,如果他们不弃用它?

是否已弃用日志记录功能?如果是这样,我们现在应该怎样做才能登录grunt?我假设我们不必使用JavaScript的document.write方法,即使它适用于grunt,但我们期望使用什么?如果没有,发生了什么以及为什么grunt使用“遗产”一词?

1 个答案:

答案 0 :(得分:3)

背景:我是Grunt团队的成员。

不推荐使用

grunt.log。由于grunt-legacy-log的内部最终将被prolog取代,因此当前的实施已移至grunt.log

请继续使用grunt.log方法。我非常怀疑我们是否会弃用该API。至多,我们可能会破坏与某些API工作方式的向后兼容性。但这只会发生在Grunt的一次轻微或重大颠簸期间,即v0.4.xv0.5.0,并且会有关于如何迁移的详细记录。

您可能会看到更多API被移出到自己的库中。这是Grunt努力使更大的Node.js社区更容易访问这些内部库并使我们更容易维护的一部分。如果有任何不推荐使用,它们将被标记为这样,我们将为用户提供迁移路径。