grunt.task

grunt.task

注冊、執(zhí)行和加載外部任務(wù)。

參見 task lib source 和 task util lib source 獲取更多信息。

The task API

當(dāng)一個任務(wù)正在執(zhí)行時，Grunt 通過this 對象向此任務(wù)函數(shù)暴露了很多任務(wù)特定的屬性和方法。參見 深入任務(wù)內(nèi)幕指南，這里可以找到完整的屬性和方法列表。

很多屬性和方法都可以通過 this 對象訪問到。

注意，任何標(biāo)記為的 ? (unicode snowman) 方法也可以直接通過 grunt 對象直接訪問到。參見 API首頁以獲取更多信息。

創(chuàng)建任務(wù)

grunt.task.registerTask

注冊 "別名任務(wù)" 或 任務(wù)函數(shù)。此方法支持以下兩種類型：

別名任務(wù)

如果指定了一個任務(wù)列表，那么，新注冊的任務(wù)將會是這一個或多個任務(wù)的別名（alias）。當(dāng)此"別名任務(wù)"執(zhí)行時，taskList中的所有任務(wù)都將按指定的順序依次執(zhí)行。taskList 參數(shù)必須是一個任務(wù)數(shù)組。

grunt.task.registerTask(taskName, taskList)

下面這個案例展示的是定義一個"default" 任務(wù)，當(dāng)執(zhí)行 Grunt 且不通過參數(shù)指定任務(wù)時， "jshint"、 "qunit"、"concat" 和 "uglify" 任務(wù)將自動執(zhí)行：

task.registerTask('default', ['jshint', 'qunit', 'concat', 'uglify']);

還可以指定任務(wù)的參數(shù)。下面的這個案例中，別名"dist"執(zhí)行了 "concat" 和 "uglify" 這兩個任務(wù)，并且都指定了"dist" 參數(shù)：

task.registerTask('dist', ['concat:dist', 'uglify:dist']);

任務(wù)函數(shù)

如果傳入description和taskFunction，每當(dāng)任務(wù)運行時，指定的函數(shù)（taskFunction）都會被執(zhí)行。此外，當(dāng)執(zhí)行 grunt --help時，前面指定的描述（description）就會顯示出來。特定任務(wù)的屬性和方法在任務(wù)函數(shù)內(nèi)部通過this對象的屬性即可訪問。如果任務(wù)函數(shù)返回false表示任務(wù)失敗。

注意，grunt.task.registerMultiTask方法將稍候介紹，它可以被用于定義一種特殊類型的任務(wù)，即"復(fù)合任務(wù)"。

grunt.task.registerTask(taskName, description, taskFunction)

下面這個案例中，當(dāng) Grunt 運行grunt foo:testing:123時，日志輸出foo, testing 123。如果運行這個任務(wù)時不帶參數(shù)，如grunt foo，日志輸出foo, no args。

grunt.task.registerTask('foo', 'A sample task that logs stuff.', function(arg1, arg2) {
  if (arguments.length === 0) {
    grunt.log.writeln(this.name + ", no args");
  } else {
    grunt.log.writeln(this.name + ", " + arg1 + " " + arg2);
  }
});

參見 創(chuàng)建任務(wù) 文檔,查看更多任務(wù)實現(xiàn)案例和別名任務(wù)。

此方法還可以通過 grunt.registerTask調(diào)用。

grunt.task.registerMultiTask

注冊一個 "復(fù)合任務(wù)（multi task）"。 復(fù)合任務(wù)是指在不指定目標(biāo)（target）時，將依次執(zhí)行其所包含的所有已命名的子屬性（sub-properties） (也就是 目標(biāo)) 。除了默認(rèn)的屬性和方法外，還可以通過this對象訪問復(fù)合任務(wù)獨有的屬性。

大多數(shù)的contrib任務(wù)，包括 jshint task、concat task 和 uglify task 都是復(fù)合任務(wù)。

grunt.task.registerMultiTask(taskName, description, taskFunction)

給定以下配置信息，當(dāng)執(zhí)行grunt log:foo時，下面的復(fù)合任務(wù)將輸出日志foo: 1,2,3；當(dāng)執(zhí)行grunt log:bar時，將輸出日志bar: hello world。如果只是執(zhí)行grunt log，那么，將先輸出日志foo: 1,2,3，然后是bar: hello world，最后是baz: false。

grunt.initConfig({
  log: {
    foo: [1, 2, 3],
    bar: 'hello world',
    baz: false
  }
});

grunt.task.registerMultiTask('log', 'Log stuff.', function() {
  grunt.log.writeln(this.target + ': ' + this.data);
});

參見 創(chuàng)建任務(wù) 文檔以獲取更多復(fù)合任務(wù)的案例。

此方法還可以通過 grunt.registerMultiTask 調(diào)用。

grunt.task.requires

Fail the task if some other task failed or never ran.

grunt.task.requires(taskName);

grunt.task.exists

Added in 0.4.5

Check with the name, if a task exists in the registered tasks. Return a boolean.

grunt.task.exists(name)

grunt.task.renameTask

重命名任務(wù)。如果你希望覆蓋某個任務(wù)的默認(rèn)行為，并且希望保留原來的名字，這個函數(shù)將會很有用。

注意，如果一個任務(wù)已經(jīng)被重命名了， this.name 和 this.nameArgs 屬性都會發(fā)生相應(yīng)的變化。

grunt.task.renameTask(oldname, newname)

此方法還可以通過 grunt.renameTask 調(diào)用。

加載外部定義的任務(wù)

對于多數(shù)項目來說，Gruntfile 文件中可能會定義很多任務(wù)。對于大型項目或者需要在多個項目中共享任務(wù)的情況，可以從一個或多個外部目錄加載任務(wù)，或者從npm安裝的 Grunt 插件加載任務(wù)。

grunt.task.loadTasks

從指定的目錄（注意：相對于 Gruntfile 所在目錄）加載任務(wù)相關(guān)的文件。此方法可以從本地Grunt插件加載任務(wù)相關(guān)的文件，只需指定包含"tasks"子目錄的插件目錄即可。

grunt.task.loadTasks(tasksPath)

此方法還可以通過 grunt.loadTasks 調(diào)用。

grunt.task.loadNpmTasks

從指定的 Grunt 插件中加載任務(wù)。此插件必須通過npm安裝到本地，并且是參照 Gruntfile 文件的相對路徑。Grunt插件還可以通過 grunt-init grunt插件模版創(chuàng)建： grunt init:gruntplugin。

grunt.task.loadNpmTasks(pluginName)

此方法還可以通過 grunt.loadNpmTasks 調(diào)用。

隊列任務(wù)

Grunt自動將命令行中指定的任務(wù)加入隊列并執(zhí)行，但是，一些獨特的任務(wù)可以向隊列中加入額外需要執(zhí)行的任務(wù)。

grunt.task.run

將一個或多個任務(wù)放入隊列中。 taskList 中的每個任務(wù)都會按照其在隊列中的順序，在當(dāng)前任務(wù)執(zhí)行完畢后立即執(zhí)行。任務(wù)列表可以是一個任務(wù)數(shù)組或單個任務(wù)。

grunt.task.run(taskList)

grunt.task.clearQueue

完全清空任務(wù)隊列。除非將額外的任務(wù)加入隊列，否則將不會執(zhí)行任何任務(wù)。

grunt.task.clearQueue()

grunt.task.normalizeMultiTaskFiles

將目標(biāo)（target）的配置對象標(biāo)準(zhǔn)化為一個src-dest文件映射數(shù)組。此方法在內(nèi)部由復(fù)合任務(wù)系統(tǒng)的this.files / grunt.task.current.files屬性調(diào)用。

grunt.task.normalizeMultiTaskFiles(data [, targetname])