阿西河

所有教程

公众号
🌙
阿西河前端的公众号

我的收藏

    最近访问  (文章)

      教程列表

      抓包专区
      测试专区

      grunt.util

      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,如果n1,返回"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)函数。

      目录
      目录