向控制台输出信息。
参见 log lib source 以获取更多信息。
Grunt的输出应当看上去一致、美观。因此, 就有了这些log方法和一些有用的模式。所有用于输出日志的方法都可以链式调用。
注意:只有在命令行中指定 --verbose
选项时,所有 grunt.verbose
中的方法才会输出日志,并且完全像 grunt.log
中的方法一样工作。
输出指定的 msg
字符串日志,结尾不带换行符(newline)。
grunt.log.write(msg)
输出指定的 msg
字符串日志,结尾带换行符(newline)。
grunt.log.writeln([msg])
如果省略msg
字符串,将会以红色字体输出ERROR
,否则输出>> msg
,并且尾部带有换行符。
grunt.log.error([msg])
使用grunt.log.error
记录一个错误日志,使用grunt.log.wraptext
可以将日志以每行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
这些方法实际上不记录日志,它们只返回字符串,返回的字符串可以用于其他方法。
Returns a comma-separated list of arr
array items. 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)
以 width
个字符为一组将 text
字符串进行分解并添加 n
字符,除非绝对必要,否则将尽量确保不会从中间截断单词。
grunt.log.wraptext(width, text)
以 width
个字符为一组将 text
字符串进行分解。Wrap texts
array of strings to columns widths
characters wide. A wrapper for the grunt.log.wraptext
method that can be used to generate output in columns.
grunt.log.table(widths, texts)
通常的模式是,只有在 --verbose
模式或发生错误时才输出日志,如下所示:
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.');
}
});
解释以上代码:
grunt.verbose.write(msg);
只有在 --verbose
模式时才会输出日志信息(没有换行符)。grunt.verbose.ok();
以绿色输出日志信息,末尾输出换行符。grunt.verbose.or.write(msg).error().error(e.message);
做了以下几件事:grunt.verbose.or.write(msg)
如果不在 --verbose
模式则输出日志信息,然后返回notverbose
对象。.error()
以红色输出ERROR日志,结尾输出换行符,然后返回 notverbose
对象。.error(e.message);
输出实际的错误信息(并返回 notverbose
对象)。grunt.fail.warn('Something went wrong.');
以嫩黄色输出警告信息。除非在命令行指定了--force
选项,否则输出退出码1,然后退出 Grunt。查看 grunt-contrib-* 任务的源码 以获取更多案例。
介绍Accordion控件是一个导航器容器,它具有子容器的集合,但每次只能看到其中一个子容器。类声明以下是 mx.containers.Accordia...
介绍Form容器允许您控制表单的布局,将表单字段标记为必需或可选,处理错误消息,并将表单数据绑定到Flex数据模型以执行数据检查...
介绍StorageClass为管理员提供了描述存储"类"的方法。不同的类型可能会映射到不同的服务质量等级或备份策略,或是由集群管理员制...