grunt.util

由 小路依依 创建， 最后一次修改 2016-10-05 grunt.util各色工具函数/库，包括 Lo-Dash、Async 和 Hooker。grunt.util.kindOf返回给定值的"类型（kind）"。就像typeof，但是其返回的是内部的[Class](class/)值。可能返回的结果是"number"、"string"、"boolean"、"function"、"regexp"、"array"、"date"、"error"、"null"、"undefined"和可以表示一切类型的 "object"。grunt.util.kindOf(value)grunt.util.error返回一个新的Error实例（也可以抛出）与相应的消息。如果指定的是Error对象而不是message，则返回对象。另外，如果为 origError 参数指定的是Error对象，并且使用 --stack 选项运行Grunt，则输出原始的Error堆栈。grunt.util.error(message [, origError])grunt.util.linefeed将换行符转换为当前系统所采用的形式（Window上是\r\n，其他系统为\n）。grunt.util.normalizelf对于一个给定的字符串，将其所有换行符转换为当前系统所采用的形式，然后返回一个新的字符串。（Window上是\r\n，其他系统为\n）grunt.util.normalizelf(string)grunt.util.recurse递归嵌套的对象和数组，为每个非对象值执行callbackFunction。如果continueFunction返回false, 给定的对象或值将会被跳过。grunt.util.recurse(object, callbackFunction, continueFunction)grunt.util.repeat返回被重复n次的字符串str。grunt.util.repeat(n, str)grunt.util.pluralize给定一个"a/b"形式的str，如果n为1，返回"a"，否则返回"b"。如果不能使用'/'，也可以指定一个自定义的分隔符。grunt.util.pluralize(n, str, separator)grunt.util.spawn生成一个子进程，并跟踪其stdout、stderr和退出码。此方法返回子进程的引用。当子进程退出时，doneFunction 函数被调用。grunt.util.spawn(options, doneFunction)options 对象可以指定以下属性：var options = { // The command to execute. It should be in the system path. cmd: commandToExecute, // If specified, the same grunt bin that is currently running will be // spawned as the child command, instead of the "cmd" option. Defaults // to false. grunt: boolean, // An array of arguments to pass to the command. args: arrayOfArguments, // Additional options for the Node.js child_process spawn method. opts: nodeSpawnOptions, // If this value is set and an error occurs, it will be used as the value // and null will be passed as the error value. fallback: fallbackValue};doneFunction 函数可以接收以下参数：function doneFunction(error, result, code) { // If the exit code was non-zero and a fallback wasn't specified, an Error // object, otherwise null. error // The result object is an object with the properties .stdout, .stderr, and // .code (exit code). result // When result is coerced to a string, the value is stdout if the exit code // was zero, the fallback if the exit code was non-zero and a fallback was // specified, or stderr if the exit code was non-zero and a fallback was // not specified. String(result) // The numeric exit code. code}grunt.util.toArray对于传入的数组或类数组对象，返回一个数组。对于将arguments对象转换为数组是非常有用的。grunt.util.toArray(arrayLikeObject)grunt.util.callbackify标准化"返回值"和"传递结果给回调"的函数，总是传递一个结果给指定的回调函数。如果原始函数返回一个值，该值将即刻传递给回调函数,，并指定为最后一个参数，在所有的预定义参数之后。如果原始函数传递一个值给回调函数,，它也会继续照样如此。grunt.util.callbackify(syncOrAsyncFunction)下面这个例子也许能够更好的说明：function add1(a, b) { return a + b;}function add2(a, b, callback) { callback(a + b);}var fn1 = grunt.util.callbackify(add1);var fn2 = grunt.util.callbackify(add2);fn1(1, 2, function(result) { console.log('1 plus 2 equals ' + result);});fn2(1, 2, function(result) { console.log('1 plus 2 equals ' + result);});内部工具库grunt.util.namespace此内部工具库用于解析对象中深度嵌套的属性。grunt.util.task用于task执行的内部工具库。外部工具库不建议使用下面列出的所有外部工具库已经不再建议使用了。请使用 npm 管理项目中对第三方工具库的依赖。例如，如果你需要使用 Lo-Dash，首先通过 npm install lodash 安装，然后在 Gruntfile 文件中使用即可： var _ = require('lodash');grunt.util._不建议使用Lo-Dash - 很多有用的数组、函数和对象工具方法。 Underscore.string - 很多实用的字符串工具函数。grunt.util._.str is available for methods that conflict with existing Lo-Dash methods.grunt.util.async不建议使用Async - 对node和浏览器都适用的异步工具。grunt.util.hooker不建议使用JavaScript Hooker - 用于调试和做些其他事情的钩子（hook）函数。