Grunt 深入任务内幕

发布时间：2023-05-16 14:18:13 所属栏目：教程来源：

导读：当一个任务执行时，Grunt通过 this 对象向此任务函数暴露了很多任务特定的属性和方法。同样这个对象也将暴露为grunt.task.current的形式在 templates中使用，例如，this.name属性也可以作为grunt.task.current.name

当一个任务执行时，Grunt通过 this 对象向此任务函数暴露了很多任务特定的属性和方法。同样这个对象也将暴露为grunt.task.current的形式在 templates中使用，例如，this.name属性也可以作为grunt.task.current.name来使用。

所有任务内部都可以使用的方法/属性
this.async
如果一个任务是异步的，必须调用此方法以通知Grunt。此方法返回一个 "done" 函数，应当在任务执行完毕后调用。false 或 Error 对象都可以传递给done函数，以通知Grunt此任务执行失败。

如果 this.async 方法没有被调用，此任务将会同步执行。

// Tell Grunt this task is asynchronous.
var done = this.async();
// Your async code.
setTimeout(function() {
// Let's simulate an error, sometimes.
var success = Math.random() > 0.5;
// All done!
done(success);
}, 1000);
this.requires
如果一个任务依赖于另外一个(或一些)任务的成功执行，在其依赖的任务没有运行或者运行失败的情况下，这个方法可以被用来强制Grunt退出。作为这个方法的参数，其依赖的任务列表可以是一个包含多个任务名称的数组，也可以是单个的任务名称。

注意，实际上这个方法并不会运行指定任务列表中的任务，它只是在任务列表中的任务没有成功运行的时候通知系统当前的任务失败了。

this.requires(tasksList)
this.requiresConfig
这个方法可以指定一个或者多个字符串或者数组的配置属性为必需的。如果一个或多个必需的配置属性缺失，就通知系统当前任务失败。

this.requiresConfig(prop [, prop [, ...]])
查看grunt.config文档了解更多关于配置属性相关的信息。

这个方式是grunt.config.requires方法的一个别名。

this.name
当前任务的名称，和定义在grunt.registerTask中的任务名一致。例如，如果以grunt sample或者grunt sample:foo的方式运行一个名为"sample"的任务，那么在这个任务函数内部，this.name的值就是"sample"。

注意，如果通过grunt.task.renaMetask 重命名了一个task，此属性也会跟着变为新名字。

this.nameArgs
当前任务的名称，包括在命令行中指定的任意使用逗号分割的参数或者标记。例如，如果以grunt sample:foo的方式运行一个名为"sample"的任务，那么在这个任务函数内部，this.nameArgs的值就是"sample:foo"。

注意，如果一个任务使用grunt.task.renaMetask方法重命名过，那么这个属性也会指向对应的新名称。

this.args
传递给当前任务的参数数组。例如，以grunt sample:foo:bar的方式运行一个名为"sample"的任务，那么在这个任务函数内部，this.args的值就是["foo", "bar"]。

注意，在多任务形式中，当前目标(名)会从this.args数组中省略。

this.flags
根据传递给当前任务的参数生成的一个对象。例如，以grunt sample:foo:bar的形式运行一个名为"sample"的任务，那么在这个任务函数内部，this.flags的值是{foo: true, bar: true}。

注意，在多任务形式中，任务目标名不会被设置为一个标记。

this.errorCount
当前任务执行期间grunt.log.error方法被调用的次数。如果在任务运行期间有错误信息输出，它可以用来让任务执行失败。

this.options
返回一个options对象。defaultsObj是一个可选参数，它的属性会被任意的任务级options对象的属性覆盖；在多任务形式中，它的属性会进一步被目标级的options对象的属性覆盖。

this.options([defaultsObj])
下面给出了一个例子，展示了在任务中可以如何使用this.options方法：

var options = this.options({
enabled: false,
});

doSomething(options.enabled);
在配置任务指南中，有一个例子展示了如何从用户任务的角度来指定options。

（编辑：汽车网）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!