【初心者向け】Node.jsでファイル書き込み時に自動でディレクトリを作成する方法3選

2024-04-17

Node.jsでファイル書き込み時にディレクトリを作成する方法

以下、ディレクトリが存在しない場合は作成し、そのディレクトリにファイルを書き込む方法を2通りご紹介します。

方法1： fs.mkdirSync() と fs.writeFileSync() を使用する

fs モジュールの mkdirSync() 関数を使用して、書き込むファイルの親ディレクトリを作成します。
fs モジュールの writeFileSync() 関数を使用して、ファイルにデータを書き込みます。

const fs = require('fs');

const filePath = 'path/to/file.txt';
const data = 'This is the data to write to the file.';

try {
  if (!fs.existsSync(path.dirname(filePath))) {
    fs.mkdirSync(path.dirname(filePath));
  }
  fs.writeFileSync(filePath, data);
  console.log('File written successfully.');
} catch (err) {
  console.error(err);
}

方法2： mkdirp モジュールを使用する

mkdirp モジュールは、再帰的にディレクトリを作成するモジュールです。このモジュールを使用すると、親ディレクトリが存在しない場合でも、自動的に作成されます。

npm install mkdirp コマンドで mkdirp モジュールをインストールします。

const fs = require('fs');
const mkdirp = require('mkdirp');

const filePath = 'path/to/file.txt';
const data = 'This is the data to write to the file.';

mkdirp(path.dirname(filePath), function(err) {
  if (err) {
    console.error(err);
    return;
  }
  fs.writeFileSync(filePath, data);
  console.log('File written successfully.');
});

補足

上記のコード例では、path モジュールを使用して、ファイルパスを操作しています。
エラー処理を適切に行うようにしてください。
より複雑なロジックの場合は、Promiseやasync/awaitを使用すると、コードが読みやすくなります。

方法1： fs.mkdirSync() と fs.writeFileSync() を使用する

const fs = require('fs');

const filePath = 'path/to/file.txt';
const data = 'This is the data to write to the file.';

try {
  if (!fs.existsSync(path.dirname(filePath))) {
    fs.mkdirSync(path.dirname(filePath));
  }
  fs.writeFileSync(filePath, data);
  console.log('File written successfully.');
} catch (err) {
  console.error(err);
}

方法2： mkdirp モジュールを使用する

const fs = require('fs');
const mkdirp = require('mkdirp');

const filePath = 'path/to/file.txt';
const data = 'This is the data to write to the file.';

mkdirp(path.dirname(filePath), function(err) {
  if (err) {
    console.error(err);
    return;
  }
  fs.writeFileSync(filePath, data);
  console.log('File written successfully.');
});

上記のコードはあくまで一例であり、状況に応じて変更する必要があります。
ファイルパスや書き込むデータは、ご自身の環境に合わせて変更してください。

Node.jsでファイル書き込み時にディレクトリを作成するその他の方法

fs.promises.mkdir() と fs.promises.writeFile() を使用する

Node.js 10以降では、fs モジュールの非同期Promise APIを使用することができます。これは、より簡潔で読みやすいコードを作成するのに役立ちます。

const fs = require('fs/promises');

const filePath = 'path/to/file.txt';
const data = 'This is the data to write to the file.';

try {
  await fs.mkdir(path.dirname(filePath), { recursive: true });
  await fs.writeFile(filePath, data);
  console.log('File written successfully.');
} catch (err) {
  console.error(err);
}

util.promisify() と fs.mkdir() と fs.writeFile() を使用する

Node.js 8以前の場合は、util.promisify() 関数を使用して、fs.mkdir() と fs.writeFile() 関数をPromiseに変換することができます。

const fs = require('fs');
const util = require('util');

const mkdir = util.promisify(fs.mkdir);
const writeFile = util.promisify(fs.writeFile);

const filePath = 'path/to/file.txt';
const data = 'This is the data to write to the file.';

try {
  await mkdir(path.dirname(filePath), { recursive: true });
  await writeFile(filePath, data);
  console.log('File written successfully.');
} catch (err) {
  console.error(err);
}

async/await 構文を使用すると、非同期コードをより同期的に記述することができます。

const fs = require('fs');

const filePath = 'path/to/file.txt';
const data = 'This is the data to write to the file.';

(async () => {
  try {
    await fs.mkdir(path.dirname(filePath), { recursive: true });
    await fs.writeFile(filePath, data);
    console.log('File written successfully.');
  } catch (err) {
    console.error(err);
  }
})();

サードパーティ製のライブラリを使用する

better-fs や graceful-fs などのサードパーティ製ライブラリを使用すると、ファイルシステム操作をより簡単に記述することができます。これらのライブラリは、Promise APIやasync/await をサポートしている場合が多く、エラー処理も容易になります。

例： better-fs を使用する

const fs = require('better-fs');

const filePath = 'path/to/file.txt';
const data = 'This is the data to write to the file.';

try {
  await fs.mkdirs(path.dirname(filePath));
  await fs.writeFile(filePath, data);
  console.log('File written successfully.');
} catch (err) {
  console.error(err);
}