grunt.util

各种实用工具，包括Lo-Dash，Async和Hooker等。

grunt.util.kindOf

返回给定值的”类型”。就像typeof运算符就会返回内部的[Class](Class/)信息。这个方法可能会返回"number"，"string"，"boolean"，"function"，"regexp"，"array"，"date"，"error"，"null"，"undefined"和代表一切类型的"object"。

  1. grunt.util.kindOf(value)

grunt.util.error

返回一个新的Error实例(它也可以抛出)与相应的消息。如果指定的是一个Error对象而不是message，会返回指定的对象。另外，如果指定一个Error对象作为origError参数，同时使用--debug 9选项运行Grunt，那么就会输出原始的Error堆栈信息。

  1. grunt.util.error(message [, origError])

grunt.util.linefeed

将换行符标准化为当前操作系统使用的形式(Window上是\r\n，否则为\n)。

grunt.util.normalizeIf

给定一个字符串，返回一个新字符串，原始字符串中所有的换行符都会被标准化为当前操作系统中使用的形式(Window上是\r\n，否则为\n)。

  1. grunt.util.normalizeIf(string)

grunt.util.recurse

以递归的方式遍历嵌套的对象和数组，然后为每个非对象类型的值执行callbackFunction(回调函数)。如果continueFunction返回false，那么就会跳过给定的对象和值。

  1. grunt.util.recurse(object, callbackFunction, continueFunction)

grunt.util.repeat

返回重复n次的字符串str。

  1. grunt.util.repeat(n, str)

grunt.util.pluralize

给定一个"a/b"形式的str，如果n为1则返回"a"；否则返回"b"。如果你不能使用’/‘，你还可以指定一个自定义的分隔符。

  1. grunt.util.pluralize(n, str, separator)

grunt.util.spawn

生成一个子进程，跟踪它的stdout(标准输出)，stderr(标准错误)和退出码代。这个方法会返回所生成的子进程的引用。当子进程退出时，就会调用done函数。

  1. grunt.util.spawn(options, doneFunction)

options对象可以指定下面这些属性：

  1. var options = {
  2.     // The command to execute. It should be in the system path.
  3.     cmd: commandToExecute,
  4.     // If specified, the same grunt bin that is currently running will be
  5.     // spawned as the child command, instead of the "cmd" option. Defaults
  6.     // to false.
  7.     grunt: boolean,
  8.     // An array of arguments to pass to the command.
  9.     args: arrayOfArguments,
  10.     // Additional options for the Node.js child_process spawn method.
  11.     opts: nodeSpawnOptions,
  12.     // If this value is set and an error occurs, it will be used as the value
  13.     // and null will be passed as the error value.
  14.     fallback: fallbackValue
  15. };

done函数可以接收以下参数：

  1. function doneFunction(error, result, code) {
  2.     // If the exit code was non-zero and a fallback wasn't specified, an Error
  3.     // object, otherwise null.
  4.     error
  5.     // The result object is an object with the properties .stdout, .stderr, and
  6.     // .code (exit code).
  7.     result
  8.     // When result is coerced to a string, the value is stdout if the exit code
  9.     // was zero, the fallback if the exit code was non-zero and a fallback was
  10.     // specified, or stderr if the exit code was non-zero and a fallback was
  11.     // not specified.
  12.     String(result)
  13.     // The numeric exit code.
  14.     code
  15. }

grunt.util.toArray

给定一个数组或者一个类数组对象，然后返回一个(新)数组。将arguments对象转换为数组是非常有用的。

  1. grunt.util.toArray(arrayLikeObject)

grunt.util.callbackify

标准化”返回值”和”传递结果给回调”的函数，并且总是传递一个结果给指定的回调函数。如果原始函数返回一个值，那么这个返回值会立即传递给回调函数，同时指定为回调函数的最后一个参数，在所有预定义的参数之后。如果原始函数给回调函数传递一个值，它也会这么做。

  1. grunt.util.callbackify(syncOrAsyncFunction)

下面这个例子也许能够更好的说明这个问题：

  1. function add1(a, b) {
  2.     return a + b;
  3. }
  4. function add2(a, b, callback) {
  5.     callback(a + b);
  6. }
  8. var fn1 = grunt.util.callbackify(add1);
  9. var fn2 = grunt.util.callbackify(add2);
  11. fn1(1, 2, function(result) {
  12.     console.log('1 plus 2 equals ' + result);
  13. });
  14. fn2(1, 2, function(result) {
  15.     console.log('1 plus 2 equals ' + result);
  16. });

内部库

grunt.util.namespace

一个用于解析对象内部深度嵌套的属性的内部库。

grunt.util.task

一个用于运行任务内部库。

外部库

grunt.util._

Lo-Dash - 它带有很多超级有用的处理数组、函数和对象的实用方法。[Underscore.string] - 它就包含了很多字符串处理的实用方法。

注意Underscore.string已经混合到grunt.util._中了，它也可以以grunt.util._.str的形式调用这个方法，但是这样做它就会与现有的Lo-Dash方法冲突。

grunt.util.async

Async - 用于Node.js和浏览器异步操作的实用工具。

grunt.util.hooker

JavaScript Hooker - 用于调试和作其他补充的补丁Monkey-patch函数。