一、grunt模塊簡介
grunt插件,是一種npm環境下的自動化工具,對于需要反復重復的任務,例如壓縮、編譯、單元測驗、linting等,自動化工具可以減輕你的勞動,簡化你的作業,grunt模塊根據Gruntfile.js檔案中的配置進行任務,
如果在package.json中定義如下命令:
"scripts": {
"build": "npm install && grunt"
}
因為運行npm run build會先安裝devDependencies中定義的一些模塊,則運行npm run build這個命令相當于做如下操作:
- npm install grunt-cli -g
- npm install
- grunt
二、gruntfile.js的結構:
- "wrapper" 函式
- 專案和任務配置
- 加載 grunt 插件和任務
- 自定義任務
三、"wrapper" 函式
每一份 Gruntfile.js(和grunt插件)都遵循同樣的格式,你所書寫的Grunt代碼必須放在此函式內:
module.exports = function(grunt){
//do grunt-related things in here
}
四、專案和任務配置
大部分的Grunt任務都依賴某些配置資料,我們通過grunt.initConfig 方法來配置Grunt任務的引數,
grunt.initConfig 方法的引數是一個JSON物件,你可以在這個配置物件中存盤任意的資料,此外,由于這本身就是JavaScript,你還可以在這里使用任意的有效的JS代碼,甚至你可以用<% %>模板字串來參考已經配置過的屬性,例如:
// 專案和任務配置
grunt.initConfig({
pkg: grunt.file.readJSON('package.json'), //獲取 package.json 中的元資料(js代碼)
proj:{
name:'hello',
description:'a hello demo'
},
hello: {
options: {
name: '<%= proj.name %>' //用<% %>模板字串匹配hello
},
srcs: ['1.txt', '2.txt']
}
});
在grunt.initConfig 方法中配置的屬性,在任務模塊中,可用grunt.config方法進行訪問,例如:
grunt.config("proj.name");
另外,grunt任務模塊會自動根據任務名來提取配置物件中和任務名對應的屬性,比如定義任務hello,則在配置物件對應的屬性"hello"中配置任務執行函式中所需用到的配置和資料,
五、加載grunt插件任務
為了減少重復勞動,我們可以加載已有的插件任務,
1.加載自己私有的grunt插件
可將自己定義的一些task腳本放在同一個目錄下,通過grunt.loadTasks方法從指定目錄加載該目錄下所有的grunt任務腳本,
2.加載在npm中發布的grunt插件
像 grunt-contrib-copy和grunt-contrib-uglify這些常用的任務都已經以grunt插件的形式被開發出來了,且被發布在npm公開庫中,只要在 package.json 檔案中將需要使用的插件列在dependency中,并通過npm install安裝之后,就可以直接加載該任務,
// 加載能夠提供"copy"任務的插件,
grunt.loadNpmTasks('grunt-contrib-copy');
3.直接加載所有以"grunt-"打頭的插件
npm上有個load-grunt-tasks插件可以用來加載dependency串列中所有以"grunt-"打頭的插件,
將需要使用的"grunt-"打頭的插件列在dependency中,然后在Gruntfile.js中進行呼叫,
//Load grunt tasks from NPM packages
load-grunt-tasks
六、自定義任務
1.直接定義任務的行為
grunt.registerTask('hello', 'Show some msg', function() {
console.log(this.options().name); //輸出hello
});
2.定義為任務串列
可以將一個任務定義為一系列任務的組合,這一系列任務將按照順序執行,
grunt.registerTask('dothings', 'copy and Show some msg', ['copy','hello']);
3.定義默認任務
通過定義 default 任務,可以讓Grunt默認執行一個或多個任務,執行 grunt 命令時如果不指定一個任務的話,將會執行默認任務,如進行下面定義的話執行grunt 相當于執行grunt hello,
grunt.registerTask('default', ['hello']);
4.定義復合任務
registerMultiTask方法可以定義一個復合任務,復合任務將會對grunt.initConfig 方法中配置的相應屬性中除了options外定義的屬性依次作為target:data對進行處理,
module.exports = function(grunt) {
grunt.initConfig({
Log: {
options: {
sep: ';'
},
srcs: ['1.txt', '2.txt'],
dests: ['d1.txt', 'd2.txt']
}
});
grunt.registerMultiTask("Log", function() {
var options = this.options({ sep: '&' });
console.log(this.target);
console.log(this.data.join(options.sep));
});
};
執行grunt Log將會輸出:
Running "Log:srcs" (Log) task
srcs
1.txt;2.txt
Running "Log:dests" (Log) task
dests
d1.txt;d2.txt
定義任務行為Tips
1.任務內部可以執行其他的任務,
grunt.registerTask('mytask', function() {
grunt.task.run('task1', 'task2');
// Or:
grunt.task.run(['task1', 'task2']);
});
2.定義異步任務
grunt.registerTask('mytask', function() {
var done = this.async();
//do something
done();
});
3.當任務失敗時,所有后續任務都將終止
在任務中,當執行失敗,可以return false來表明當前任務執行失敗,一般,多個任務按順序執行,如果有任務失敗時,所有后續任務都將終止,可以通過在命令列后加上--force來使有任務失敗時,后續任務能繼續進行,
4.任務中檢查前置任務狀態
有些任務可以依賴于其他任務的成功執行,通過grunt.task.requires方法來檢查其前置任務是否已經執行,并且沒有失敗,
5.任務中檢查配置屬性
可以用方法grunt.task.requiresConfig指定一個或者多個字串或者陣列的配置屬性為必需的,如果一個或多個必需的配置屬性缺失,就通知系統當前任務失敗,
轉載請註明出處,本文鏈接:https://www.uj5u.com/qiye/171278.html
標籤:JavaScript
下一篇:ES6 ... 展開&收集運算子
