grunt.util
Miscellaneous utilities for your Gruntfile and tasks.
grunt.util.kindOf
Return the "kind" of a value. Like typeof
but returns the internal [Class](Class/)
value. Possible results are "number"
, "string"
, "boolean"
, "function"
, "regexp"
, "array"
, "date"
, "error"
, "null"
, "undefined"
and the catch-all "object"
.
grunt.util.kindOf(value)
grunt.util.error
Return a new Error instance (that can be thrown) with the appropriate message. If an Error object is specified instead of message
that object will be returned. Also, if an Error object is specified for origError
and Grunt was run with the --stack
option, the original Error stack will be dumped.
grunt.util.error(message [, origError])
grunt.util.linefeed
The linefeed character, normalized for the current operating system. (\r\n
on Windows, \n
otherwise)
grunt.util.normalizelf
Given a string, return a new string with all the linefeeds normalized for the current operating system. (\r\n
on Windows, \n
otherwise)
grunt.util.normalizelf(string)
grunt.util.recurse
Recurse through nested objects and arrays, executing callbackFunction
for each non-object value. If continueFunction
returns false
, a given object or value will be skipped.
grunt.util.recurse(object, callbackFunction, continueFunction)
grunt.util.repeat
Return string str
repeated n
times.
grunt.util.repeat(n, str)
grunt.util.pluralize
Given str
of "a/b"
, If n
is 1
, return "a"
otherwise "b"
. You can specify a custom separator if '/' doesn't work for you.
grunt.util.pluralize(n, str, separator)
grunt.util.spawn
Spawn a child process, keeping track of its stdout, stderr and exit code. The method returns a reference to the spawned child. When the child exits, the doneFunction
is called.
grunt.util.spawn(options, doneFunction)
The options
object has these possible properties:
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 };
The doneFunction
accepts these arguments:
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
Given an array or array-like object, return an array. Great for converting arguments
objects into arrays.
grunt.util.toArray(arrayLikeObject)
grunt.util.callbackify
Normalizes both "returns a value" and "passes result to a callback" functions to always pass a result to the specified callback. If the original function returns a value, that value will now be passed to the callback, which is specified as the last argument, after all other predefined arguments. If the original function passed a value to a callback, it will continue to do so.
grunt.util.callbackify(syncOrAsyncFunction)
This example might better illustrate:
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); });
Internal libraries
grunt.util.namespace
An internal library for resolving deeply-nested properties in objects.
grunt.util.task
An internal library for task running.
External libraries
Deprecated
All external libraries that are listed below are now deprecated.
Please use npm to manage these external libraries in your project's dependencies.
For example if you want to use Lo-Dash, install it first: npm install lodash
, then use it in your Gruntfile
: var _ = require('lodash');
.
grunt.util._
Deprecated
grunt.util._.str
is available for methods that conflict with existing Lo-Dash methods.
grunt.util.async
Deprecated
Async - Async utilities for node and the browser.
grunt.util.hooker
Deprecated
JavaScript Hooker - Monkey-patch (hook) functions for debugging and stuff.
© GruntJS Team
Licensed under the MIT License.
https://gruntjs.com/api/grunt.util