跳转: gulp.src | gulp.dest | gulp.task | gulp.watch
输出(Emits)符合所提供的匹配模式(glob)或者匹配模式的数组(array of globs)的文件。 将返回一个 Vinyl files 的 stream 它可以被 piped 到别的插件中。
gulp.src('client/templates/*.jade')
.pipe(jade())
.pipe(minify())
.pipe(gulp.dest('build/minified_templates'));
glob
请参考 node-glob 语法 或者,你也可以直接写文件的路径。
类型: String
或 Array
所读取的 glob 或者 glob 数组,除了 negation(!
) 以外的 node-glob 语法 均被支持。
一个 !
开头的 glob 会在结果中排除掉到这个地方为止的所匹配到的文件。举个例子,考虑如下的目录结构:
client/
a.js
bob.js
bad.js
下面的表达式匹配到的结果是 a.js
和 bad.js
:
gulp.src(['client/*.js', '!client/b*.js', 'client/bad.js'])
类型: Object
通过 [glob-stream] 所传递给 node-glob 的参数。
除了 node-glob 和 [glob-stream] 所支持的参数(除了 ignore
)外,gulp 增加了一些额外的选项参数:
类型: Boolean
默认值: true
如果该项被设置为 false
,那么将会以 stream 方式返回 file.contents
而不是文件 buffer 的形式。这在处理一些大文件的时候将会很有用。注意:插件可能并不会实现对 stream 的支持。
类型: Boolean
默认值: true
如果该项被设置为 false
, 那么 file.contents
会返回空值(null),也就是并不会去读取文件。
类型: String
默认值: 将会加在 glob 之前 (请看 glob2base)
如, 请想像一下在一个路径为 client/js/somedir
的目录中,有一个文件叫 somefile.js
:
gulp.src('client/js/**/*.js') // 匹配 'client/js/somedir/somefile.js' 并且将 `base` 解析为 `client/js/`
.pipe(minify())
.pipe(gulp.dest('build')); // 写入 'build/somedir/somefile.js'
gulp.src('client/js/**/*.js', { base: 'client' })
.pipe(minify())
.pipe(gulp.dest('build')); // 写入 'build/js/somedir/somefile.js'
能被 pipe 进来,并且将会写文件。并且重新输出(emits)所有数据,因此你可以将它 pipe 到多个文件夹。如果某文件夹不存在,将会自动创建它。
gulp.src('./client/templates/*.jade')
.pipe(jade())
.pipe(gulp.dest('./build/templates'))
.pipe(minify())
.pipe(gulp.dest('./build/minified_templates'));
文件被写入的路径是以所给的相对路径根据所给的目标目录计算而来。类似的,相对路径也可以根据所给的 base 来计算。
请查看上述的 gulp.src
来了解更多信息。
类型: String
or Function
文件将被写入的路径(输出目录)。也可以传入一个函数,在函数中返回相应路径,这个函数也可以由 vinyl 文件实例 来提供。
类型: Object
类型: String
默认值: process.cwd()
输出目录的 cwd
参数,只在所给的输出目录是相对路径时候有效。
类型: String
默认值: 0777
八进制权限字符,用以定义所有在输出目录中所创建的目录的权限。
定义一个使用 Orchestrator 实现的任务(task)。
gulp.task('somename', function() {
// 做一些事
});
类型:String
任务的名字,如果你需要在命令行中运行你的某些任务,那么,请不要在名字中使用空格。
类型: Array
一个包含任务列表的数组,这些任务会在你当前任务运行之前完成。
gulp.task('mytask', ['array', 'of', 'task', 'names'], function() {
// 做一些事
});
注意: 你的任务是否在这些前置依赖的任务完成之前运行了?请一定要确保你所依赖的任务列表中的任务都使用了正确的异步执行方式:使用一个 callback,或者返回一个 promise 或 stream。
你也可以省略最后那个函数,如果你只是想要执行依赖的任务:
gulp.task('mytask', ['array', 'of', 'task', 'names']);
注意: 这些任务会一次并发执行,因此,请不要假定他们会按顺序开始和结束。
类型:Function
该函数定义任务所要执行的主要操作。通常来说,它会是这种形式:
gulp.task('buildStuff', function() {
// Do something that "builds stuff"
var stream = gulp.src(/*some source path*/)
.pipe(somePlugin())
.pipe(someOtherPlugin())
.pipe(gulp.dest(/*some destination*/));
return stream;
});
任务可以异步执行,如果 fn
能做到以下其中一点:
// 在 shell 中运行一个命令
var exec = require('child_process').exec;
gulp.task('jekyll', function(cb) {
// 构建 Jekyll
exec('jekyll build', function(err) {
if (err) return cb(err); // return error
cb(); // 完成 task
});
});
// 在 pipe 中使用异步的结果
gulp.task('somename', function(cb) {
getFilesAsync(function(err, res) {
if (err) return cb(err);
var stream = gulp.src(res)
.pipe(minify())
.pipe(gulp.dest('build'))
.on('end', cb);
});
});
gulp.task('somename', function() {
var stream = gulp.src('client/**/*.js')
.pipe(minify())
.pipe(gulp.dest('build'));
return stream;
});
var Q = require('q');
gulp.task('somename', function() {
var deferred = Q.defer();
// 执行异步的操作
setTimeout(function() {
deferred.resolve();
}, 1);
return deferred.promise;
});
注意: 默认的,task 将以最大的并发数执行,也就是说,gulp 会一次性运行所有的 task 并且不做任何等待。如果你想要创建一个序列化的 task 队列,并以特定的顺序执行,你需要做两件事:
对于这个例子,让我们先假定你有两个 task,"one" 和 "two",并且你希望它们按照这个顺序执行:
在 "one" 中,你加入一个提示,来告知什么时候它会完成:可以再完成时候返回一个 callback,或者返回一个 promise 或 stream,这样系统会去等待它完成。
在 "two" 中,你需要添加一个提示来告诉系统它需要依赖第一个 task 完成。
因此,这个例子的实际代码将会是这样:
var gulp = require('gulp');
// 返回一个 callback,因此系统可以知道它什么时候完成
gulp.task('one', function(cb) {
// 做一些事 -- 异步的或者其他的
cb(err); // 如果 err 不是 null 或 undefined,则会停止执行,且注意,这样代表执行失败了
});
// 定义一个所依赖的 task 必须在这个 task 执行之前完成
gulp.task('two', ['one'], function() {
// 'one' 完成后
});
gulp.task('default', ['one', 'two']);
监视文件,并且可以在文件发生改动时候做一些事情。它总会返回一个 EventEmitter 来发射(emit) change
事件。
类型: String
or Array
一个 glob 字符串,或者一个包含多个 glob 字符串的数组,用来指定具体监控哪些文件的变动。
类型: Object
传给 gaze
的参数。
类型: Array
需要在文件变动后执行的一个或者多个通过 gulp.task()
创建的 task 的名字,
var watcher = gulp.watch('js/**/*.js', ['uglify','reload']);
watcher.on('change', function(event) {
console.log('File ' + event.path + ' was ' + event.type + ', running tasks...');
});
类型: String
or Array
一个 glob 字符串,或者一个包含多个 glob 字符串的数组,用来指定具体监控哪些文件的变动。
类型: Object
传给 gaze
的参数。
类型: Function
每次变动需要执行的 callback。
gulp.watch('js/**/*.js', function(event) {
console.log('File ' + event.path + ' was ' + event.type + ', running tasks...');
});
callback 会被传入一个名为 event
的对象。这个对象描述了所监控到的变动:
类型: String
发生的变动的类型:added
, changed
, deleted
或者 renamed
。
类型: String
触发了该事件的文件的路径。