输出信息到控制器。
查看log库源文件可以了解更多详细信息。
Grunt输出看起来应该是一致的,甚至是漂亮的。因此,这里有大量的日志记录相关的方法和一些很有用的模式。所有的这些方法实际上记录的东西的都是可连接的。
注意:所有grunt.verbose下可用的方法都酷似grunt.log方法,不同的是,如果指定--verbose命令行选项,那么它就只会记录日志信息。
输出指定的msg字符串信息,尾部不带换行符。
grunt.log.write(msg);
输出指定的msg字符串信息,尾部带有换行符。
grunt.log.writeln([msg]);
如果忽略了msg字符串,它会输出红色的ERROR信息;否则输出>> msg并且尾部带有换行符。
grunt.log.error([msg])
使用grunt.log.error会输出一个错误日志信息,使用grunt.log.wraptext可以做到每80个文本就换行(即保证输出最大列数为80列)。
grunt.log/errorlns(msg)
如果忽略msg字符串,它会输出绿色的OK信息;否则输出>> msg并且尾部带有换行符。
grunt.log.ok([msg])
使用grunt.log.ok方法输出一个ok信息,使用grunt.log.wraptext可以做到每80个文本就换行。
grunt.log.oklns(msg)
以加粗的形式输出指定的msg字符串,尾部带有换行符。
grunt.log.subhead(msg)
输出一个obj属性列表(它是很好的调试标志)。
grunt.log.writeflags(obj, prefix)
输出一个调试信息,但是只在指定--debug命令行选项的情况下才会输出。
grunt.log.debug(msg)
所有grunt.verbose下可用的日志记录方法的工作都酷似它们所对应的grunt.log方法,但是它们只在指定--verbose命令行选项的情况下才一样。还有一个对应"notverbose"适用于grunt.log.notverbose和grunt.log.verbose.or。实际上,.or属性也可以用于在verbose和notverbose两者之间有效的进行切换。
这个对象包含grunt.log下的所有方法,但是只在指定--verbose命令行选项情况下它才会输出日志信息。
grunt.verbose
这个对象也包含grunt.log下的所有方法,但是只在不指定--verbose命令行选项情况下它才会输出日志信息。
grunt.verbose.or
这些方法不会真正输出日志信息,它们只返回可以用于其他方法中的字符串。
返回一个逗号分割的arr数组项目。
grunt.log.wordlist(arr [, options])
options对象可以使用以下属性,并且还可以设置它们默认值:
var options = { // The separator string (can be colored). separator: ', ', // The array item color (specify false to not colorize). color: 'cyan', };
从字符串中移除所有的彩色信息,使它适用于测试.length属性或者可以输出到一个日志记录文件中。
grunt.log.uncolor(str)
将text字符串包装为width指定宽度字符列并在尾部添加一个\n(换行符),确保单词没有从中间分割,除非绝对必要的情况下才可以使用分割的单词。
grunt.log.wraptext(width, text)
将texts字符串数组包装为widths指定宽度的字符串列数。包装函数grunt.log.wraptext方法可以用于生成输出列。
grunt.log.table(widths, texts)
一个常见的模式,发生错误时,它只在指定--verbose mode OR选项的情况下输出日志信息。就像下面这样:
grunt.registerTask('something', 'Do something interesting.', function(arg) { var msg = 'Doing something...'; grunt.verbose.write(msg); try { doSomethingThatThrowsAnExceptionOnError(arg); // Success! grunt.verbose.ok(); } catch(e) { // Something went wrong. grunt.verbose.or.write(msg).error().error(e.message); grunt.fail.warn('Something went wrong.'); } });
关于以上代码的说明: