gulp 入門者向けの gulp を使うために必要な基礎知識を解説します。目標は、gulp を使う準備が整うことです。JavaScript の基本的な知識を前提としています。
gulp とは
gulp は、いわゆるタスクランナーの一種で、予めタスクを登録しておくことで、後から手動または自動でタスクを実行してくれるツールです。
例えば、Sass ファイルを CSS へとコンパイルする場合、一口にコンパイルといってもいろいろなオプションや中間処理が考えられます。そういった一連の処理をタスクとして設定しておくと、コマンド1つで実行することができるようになります。
タスクランナーは他に、Grunt や npm などがありますがありますが、機能が充実していて扱いやすい gulp がおすすめです。
gulp を導入する
gulp を使うには、 Node.js の環境が必要です。ここでは、Node.js がコンピュータにインストールされているという前提で解説を行います。
まず、カレントディレクトリをプロジェクトルートに移動します。
- cd my-project
次に、gulp をローカルインストールします。
- npm install --save-dev gulp
- CLI version: 2.2.0
- Local version: 4.0.2
これにより、プロジェクト my-project は、次のような構成になっています。
- my-project/
- ├─ node-modules/
- │ ├─ ...
- │ └─ gulp/
- ├─ package.json
- ├─ package.lock.json
- ...
ここで、合わせて gulpfile.js
を作成しましょう。gulpgile.js
は、gulp で処理を記述するためのファイルです。とりあえずの作成なため、何も記述せずにファイルの作成だけ行ってしまいましょう。
最終的なプロジェクトの構成:
- my-project/
- ├─ node-modules/
- ├─ gulpfile.js
- ├─ package.json
- ├─ package.lock.json
- ...
gulpfile.js
gulp では、gulpfile.js
に実行する処理の記述を行っていきます。ファイル名から分かる通り、 JavaScript (Node.js)で記述を行います。
gulp は API が用意されており、API を使って処理内容を定義していきます。
- // はじめに、gulp オブジェクトをインポートします。API はこのオブジェクトに含まれています。
- const gulp = require('gulp');
タスクの定義
JavaScript の関数を使って gulp に処理させるタスクを定義していきます。
- function task1(callback) {
- // ここにタスクの処理を記述
- callback();
- }
タスクは、非同期で実行されるため、第一引数にコールバックを受け取ります。
タスクにはパブリックなタスクとプライベートなタスクがあります。
- パブリックなタスクは、gulp コマンドで利用できます。タスクは、gulpfile からエクスポートするとパブリックになります。エクスポート名を
default
とするとデフォルトタスクになります。 - プライベートなタスクは、内部で
series()
メソッドまたはparallel()
メソッドで利用されます。
- function publicTask(callback) {
- // タスクの処理...
- callback();
- }
-
- function privateTask(callback) {
- // タスクの処理...
- callback();
- }
-
- exports.publicTask = publicTask;
- exports.default = series(privateTask, publicTask);
gulp
コマンドによる実行は次のように行います。
- gulp
- gilp タスク名
タスクの実行(直列)
タスクを直列に実行するには、series()
メソッドを使います。
- // series() メソッドをインポートします。
- const { series } = require('gulp');
-
- // 「タスクA」を定義
- function taskA(callback) {
- // タスクAの処理...
- callback();
- }
-
- // 「タスクB」を定義
- function taskB(callback) {
- // タスクBの処理...
- callback();
- }
-
- // タスクA→タスクBの順に実行されるパブリックな「タスクAB」
- exports.taskAB = series(taskA, taskB);
例えば、上記の例に当てはめるなら、タスクAがトランスパイル処理、タスクBがバンドル処理にすれば、タスクABはビルド処理とすることができます。
タスクの実行(並列)
タスクを並列に実行するには、parallel()
メソッドを使います。
- // parallel() メソッドをインポートします。
- const { parallel } = require('gulp');
-
- // 「タスクA」を定義 function taskA(callback) {
- // タスクAの処理...
- callback();
- }
-
- // 「タスクB」を定義
- function taskB(callback) {
- // タスクBの処理...
- callback();
- }
-
- // タスクAとタスクBを実行するパブリックな「taskAll」
- exports.taskAll = parallel(taskA, taskB);
例えば、こちらも上記の例に当てはめるなら、タスクAがJavaScriptトランスパイル処理、タスクBがSassコンパイル処理にすれば、タスクABはプロジェクト全体のトランスパイル・コンパイル処理にかかる時間を短縮できます。
gulp でファイルを読み込むには src()
メソッドを使います。書き出しは dest()
メソッドを使います
- const { src, dest } = require('gulp');
-
- exports.default = function() {
- return src('src/*.js')
- .pipe(dest('output/'));
- }
この例では、タスクの完了をコールバック関数を呼び出すのではなく、ストリームを返すという方法をとっています。src()
メソッドは、ストリームを生成するので、それを pipe()
メソッドで引き継いでいます。
グロブ(ワイルドカード)
src()
メソッドではグロブ(*
)が使用できます。グロブはワイルドカードとも呼ばれ、任意の文字列を表します。
ファイルをグロブで表す:
- src('src/*.scss')
ディレクトリをグロブで表す:
- src('src/*/*.scss')
ディレクトリをグロブで再起的に表す:
src('src/*/.scss')
node_modules/
を除外する:
- src(['**/*.js', '!node_modules/**'])
プラグインの利用
gulp プラグインは、パイプラインでファイルを変換する一般的な動作をカプセル化するノード変換ストリームです。難しい言い方をしてしまいましたが、要するに、ファイルの入力と出力の間で使う便利な機能です。gulp は、このプラグインを使うことでかなり便利になります。
ワンポイント
ファイルの入力は src()
メソッドで、ファイルの出力は dest()
メソッドで、そしてプラグインはその間に挟んで使用します。ストリームを扱うので、コールバック呼び出しではなく return
する方法が一般的です。
- const { src, dest } = require('gulp');
-
- // プラグインのインポート
- const sass = require('gulp-sass');
- exports.sassCompile = function () {
- return src('src/scss/style.scss')
- .pipe(sass())
- .pipe(dest('dist/'));
- }
ファイル監視
ファイル監視を行えば、ファイルに変更があった際にタスクを実行できます。ファイル監視は watch()
メソッドを使用します。
- const { watch, series } = require('gulp');
-
- function clean(callback) {
- // ...
- callback();
- }
-
- function javascript(callback) {
- // ...
- callback();
- }
-
- function css(callback) {
- // ...
- callback();
- }
-
- exports.default = function() {
- // CSS ファイルを監視
- watch('src/*.css', css);
- // JS ファイルを監視
- watch('src/*.js', series(clean, javascript));
- };
特定のイベントを監視する
デフォルトでは、ファイル監視は、ファイルの作成、変更、または削除の度にタスクを実行します。これを変更するには、events
オプションにキーワードを指定します。
- const { watch } = require('gulp');
-
- exports.default = function() {
- // All events will be watched
- watch('src/*.js', { events: ['add', 'change'] }, function(callback) {
- // ...
- callback();
- });
- };
キーワードには、次のものが指定できます。
- add
- addDir
- change
- unlink
- unlinkDir
- ready
- error
- all