ディレクトリ内のファイルやディレクトリを列挙する（一階層のみ）

Node.js の標準モジュールである fs モジュールの readdir() を使用して、指定したディレクトリ内のファイル、ディレクトリを列挙することができます。

• fs.readdir function

見つかったファイル群は、コールバックの第 2 引数に配列の形で渡されます。 ドット (.) で始まるファイルやディレクトリは検索対象になりますが、カレントディレクトリ (.) や、親ディレクトリ (..) は結果に入りません。

下記は、カレントディレクトリ内のファイルとディレクトリを列挙するサンプルです。

sample.js

var fs = require('fs');

fs.readdir('.', function (err, files) {
  if (err) {
    console.error(err);
  } else {
    console.log(files);
  }
});

実行例

$ node sample
[ 'dummy.txt', 'dummy_dir', 'sample.js' ]

指定したディレクトリが存在しない場合は、ENOENT (-2) エラーが発生します。

D:\y\sandbox\node> node sample
{ Error: ENOENT: no such file or directory, scandir 'D:\y\sandbox\node\aaaa'
    at Error (native)
  errno: -4058,
  code: 'ENOENT',
  syscall: 'scandir',
  path: 'D:\\y\\sandbox\\node\\aaaa' }

ディレクトリ内のファイルを再帰的に列挙する

下記の dirutil モジュールは、指定したディレクトリ内のファイルを再帰的に列挙する walkDir 関数を提供します。

• dirutil.js

例えば、ディレクトリ構成が下記のようになっている時、

dir1
  +— file1
  +— dir2
  | +— file2
  +— dir3
    +— file3

walkDir('dir1', callback) と呼び出した場合に、callback の第二引数に、dir2/file2 のようなファイルパスを表す文字列が渡されて呼び出されます。 このコールバックはファイルが見つかるごとに呼び出されます（ファイルパスをリスト形式で受け取るバージョンは後述）。

使用例

var dirutil = require('./dirutil');
dirutil.walkDir('dir1', function (err, path) {
  console.log(path);
});

実行結果

file1
dir2/file2
dir3/file3

上記の例では、ファイルが見つかる度にコールバックが呼び出されますが、この実装はちょっと使いにくいかもしれません。 再帰的に検索して見つかったファイルのパスを、配列データとしてまとめて受け取るには、下記のように実装します。

• dirutil.js（見つかったファイルを配列で返すバージョン）

使用例

var dirutil = require('./dirutil');
dirutil.walkDir('dir1', function (err, list) {
  console.log(list);
});

実行結果

[ 'file1', 'dir2/file2', 'dir3/file3' ]