关于gulp:Gulp-API

本节咱们来看一下 Gulp 中的 API 办法，如下所示：

咱们在应用 gulp 时，个别只须要用到 4 个 API，别离是 gulp.src()、gulp.dest()、gulp.task()、gulp.watch()，上面咱们具体介绍一个这 4 个罕用 API 的应用。

gulp.src() 办法

gulp.src() 办法用于创立一个流。然而要留神的是这个流里的内容不是原始的文件流，而是一个虚构文件对象流（vinyl files），这个虚构文件对象中存储着原始文件的门路、文件名、内容等信息。

语法如下所示：

gulp.src(globs, [options])

• globs：文件匹配模式（类型正则表达式），用来匹配文件门路（包含文件名），也能够间接指定某个具体的文件门路。
• options：可选参数，通常状况下不须要用到。

示例：

例如上面这个例子，将 input 文件夹中的 .js 文件复制到 output 文件夹中：

const {src, dest} = require('gulp');

function copy() {return src('input/*.js')
    .pipe(dest('output/'));
}

exports.copy = copy;

执行 gulp copy 命令后，文件胜利被复制。

gulp.dest() 办法

gulp.dest() 办法能够创立一个用于将 Vinyl 对象写入到文件系统的流。

语法如下：

gulp.dest(path[ , options])

• path：为写入文件的门路。
• options：可选的参数对象，通常用不到。

gulp.dest() 办法是和 gulp.src() 办法搭配应用的，例如上述这个复制文件的示例。

gulp 的应用流程个别是，首先通过 gulp.src() 办法获取咱们想要解决的文件流，而后把文件流通过 pipe 办法导入到 gulp 插件中，最初把通过插件解决后的流再通过 pipe 办法导入到 gulp.dest() 中，gulp.dest() 办法则把流中的内容写入到文件中。

留神，给 gulp.dest() 传入的门路参数，只能用来指定要生成的文件的目录，而不能指定生成文件的文件名，它生成文件的文件名应用的是导入到它的文件流本身的文件名，所以生成的文件名是由导入到它的文件流决定的。

gulp.task() 办法

gulp.task() 办法用于在工作零碎中定义工作，而后能够从命令行和 series()、parallel()、lastrun() 等 API 拜访该定义好的工作。

语法如下所示：

gulp.task(name [ , deps] , fn )

• name：工作名。
• deps：是以后定义的工作须要依赖的其余的工作，为一个数组。以后定义的工作会在所有依赖的工作执行结束后才开始执行。如果没有依赖，则能够省略这个参数。
• fn：可选参数，为工作函数，咱们把工作要执行的代码都写在外面。

示例：

task() 办法的用法有上面几种：

• 将命名函数注册为工作，其中函数名 test 就是工作名：

const {task} = require('gulp');

function test(cb) {console.log("命令函数")
  cb();}

task(test);

• 将匿名函数注册为工作：

const {task} = require('gulp');

task('test', function(cb) {console.log("匿名函数")
  cb();});

• 检索先前已注册的工作：

const {task} = require('gulp');

task('test', function(cb) {cb();
});

const test = task('test');

gulp.watch() 办法

gulp.watch() 办法用来监督文件的变动，当文件发生变化后，咱们能够利用它来执行相应的工作，例如文件压缩等。

语法如下所示：

gulp.watch(glob [ , opts] , tasks)

• glob：为要监督的文件匹配模式，规定和用法与 gulp.src() 办法中的 glob 雷同。
• opts：为一个可选的配置对象，通常不须要用到。
• tasks：为文件变动后要执行的工作，为一个数组。

示例：

例如应用 gulp.watch 语句监听文件变动：

const {watch} = require('gulp');

watch(['input/*.js', '!input/one.js'], function(cb) {cb();
});