情報アイランド

「情報を制する者は世界を制す」をモットーに様々な情報を提供することを目指すブログです。現在はプログラミング関連情報が多めですが、投資関連情報も取り扱っていきたいです。

Node.jsでフォルダを作成する

フォルダを作成するには非同期的に作成する方法と同期的に作成する方法の2つがあります。

非同期的な作成

フォルダを非同期的に作成するにはfs.mkdir関数を使用します。

var fs = require('fs');

fs.mkdir('xxx', function (err) {
});

第1引数にフォルダのパスを指定します。

第2引数にコールバック関数を指定します。この関数の第1引数はエラーオブジェクトです。

同期的な作成

フォルダを同期的に作成するにはfs.mkdirSync関数を使用します。

fs.mkdirSync('xxx');

第1引数にフォルダのパスを指定します。

使い分け

原則的にはfs.mkdir関数を使用するべきであり、特に理由がないならfs.mkdirSync関数は使用するべきではありません。

これは、フォルダへのアクセスは非常に時間の掛かる処理であるためです。フォルダへのアクセスを同期的に行うとアクセスが完了するまでプログラムは待機状態となり、他の処理を行うことができません。長い時間プログラムが待機状態になると様々な問題を引き起こす可能性があります(このような現象をスターベーションと言います)。

注意事項

fs.mkdir関数やfs.mkdirSync関数はフォルダを再帰的に作成することはできません。

フォルダを再帰的に作成するには下のような関数を使用します。

  • mkdirpモジュールのmkdirp関数
  • fs-extraモジュールのfsExtra.mkdirp関数
  • mkdirpモジュールのmkdirp.sync関数
  • fs-extraモジュールのfsExtra.mkdirpSync関数

これらの関数に関しては下の記事を参照してください。

サンプルコード1

fs.mkdir関数の使用例です。

3つ目のコマンドライン引数として与えられたフォルダを非同期的に作成します。

fs-mkdir.js

var fs = require('fs');

if (process.argv.length < 3) {
    console.error('lack argument.');
    process.exit(1);
}

fs.mkdir(process.argv[2], function (err) {
    if (err) {
        console.error(err);
        process.exit(1);
    }
    else {
        console.log('finished!!');
    }
});

実行結果

現在のフォルダにはtmpという名称のフォルダは存在していません。

C:\work\node>dir tmp
 Volume in drive C is TI31035600A
 Volume Serial Number is 1CBD-3C48

 Directory of C:\work\node

File Not Found

tmpを3つ目のコマンドライン引数に指定してコードを実行するとフォルダが作成されます。

C:\work\node>node fs-mkdir.js tmp
finished!!

C:\work\node>dir tmp
 Volume in drive C is TI31035600A
 Volume Serial Number is 1CBD-3C48

 Directory of C:\work\node\tmp

2016/10/08  09:35    <DIR>          .
2016/10/08  09:35    <DIR>          ..
               0 File(s)              0 bytes
               2 Dir(s)  29,740,929,024 bytes free

存在するファイルやフォルダを指定した場合にはエラーが発生します。

C:\work\node>node fs-mkdir.js tmp
{ Error: EEXIST: file already exists, mkdir 'C:\work\node\tmp'
    at Error (native)
  errno: -4075,
  code: 'EEXIST',
  syscall: 'mkdir',
  path: 'C:\\work\\node\\tmp' }

C:\work\node>node fs-mkdir.js fs-mkdir.js
{ Error: EEXIST: file already exists, mkdir 'C:\work\node\fs-mkdir.js'
    at Error (native)
  errno: -4075,
  code: 'EEXIST',
  syscall: 'mkdir',
  path: 'C:\\work\\node\\fs-mkdir.js' }

また、フォルダを再帰的に作成することはできません。

C:\work\node>node fs-mkdir.js tmp\tmp2\tmp3
{ Error: ENOENT: no such file or directory, mkdir 'C:\work\node\tmp\tmp2\tmp3'
    at Error (native)
  errno: -4058,
  code: 'ENOENT',
  syscall: 'mkdir',
  path: 'C:\\work\\node\\tmp\\tmp2\\tmp3' }

関連

pizyumi
プログラミング歴19年のベテランプログラマー。業務システム全般何でも作れます。現在はWeb系の技術を勉強中。
スポンサーリンク

-Node.js