プログラミング初心者でも安心！Node.jsでJSONファイルを扱う方法

2024-06-30

Node.jsを使ってJSONファイルの値を更新して保存する方法

必要なもの

Node.js環境
更新対象のJSONファイル

手順

必要なモジュールのインストール
```
npm install fs json5
```

JSONファイルの読み込み

fs.readFile関数を使って、JSONファイルを非同期で読み込みます。読み込んだ内容は、JavaScriptオブジェクトとして扱えます。

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

fs.readFile('data.json', (err, data) => {
    if (err) {
        console.error(err);
        return;
    }

    const jsonData = json5.parse(data);
    console.log(jsonData);
});

値の更新
読み込んだJSONオブジェクトを操作して、更新したい値を変更します。
```
// 例： "name" プロパティの値を "Taro Yamada" に更新
jsonData.name = 'Taro Yamada';
```
fs.writeFileSync関数を使って、更新したJSONオブジェクトをJSONファイルに書き込みます。
```
fs.writeFileSync('data.json', json5.stringify(jsonData));
```

補足

上記は基本的な例であり、実際のユースケースに合わせて様々な処理を追加することができます。
エラー処理や非同期処理の適切な扱いなど、開発者としての基本的なスキルも必要となります。
より高度な操作については、Node.jsのドキュメントやライブラリに関する情報も参照してください。

上記以外にも、Node.jsでJSONファイルを操作する方法はいくつかあります。ご自身の目的に合った方法を選択してください。

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

// data.jsonファイルを読み込む
fs.readFile('data.json', (err, data) => {
  if (err) {
    console.error(err);
    return;
  }

  // JSONデータを解析してJavaScriptオブジェクトに変換
  const jsonData = json5.parse(data);

  // "name"プロパティの値を更新
  jsonData.name = 'Taro Yamada';

  // 更新したデータをJSON形式に変換
  const updatedData = json5.stringify(jsonData);

  // data.jsonファイルに書き込む
  fs.writeFileSync('data.json', updatedData);

  console.log('JSONファイルの更新が完了しました。');
});

説明

最初に、必要なモジュールであるfsとjson5をインポートします。
fs.readFile関数を使ってdata.jsonファイルを読み込み、エラー処理を行います。
読み込んだデータは、json5.parse関数を使ってJavaScriptオブジェクトに変換されます。
変換されたオブジェクトのnameプロパティの値を"Taro Yamada"に更新します。
更新後のオブジェクトをjson5.stringify関数を使ってJSON形式に変換します。
最後に、処理完了メッセージを出力します。

ポイント

ファイルパスやプロパティ名は、ご自身の環境に合わせて変更してください。
エラー処理や非同期処理の適切な扱いについては、ご自身で調べて理解する必要があります。

このサンプルコードを参考に、様々なJSONファイル操作を習得することができます。

Node.jsでJSONファイルを更新するその他の方法

npmパッケージを使用する

利点: 簡単で直感的
欠点: 柔軟性に欠ける、特定のニーズに合わない場合がある

この方法は、jsonまたはjson5のようなnpmパッケージを使用して、JSONファイルを操作します。以下に例を示します。

const fs = require('fs');
const JsonData = require('json');

// data.jsonファイルを読み込む
fs.readFile('data.json', (err, data) => {
  if (err) {
    console.error(err);
    return;
  }

  // JSONデータを解析
  const jsonData = JsonData.parse(data);

  // "name"プロパティの値を更新
  jsonData.name = 'Taro Yamada';

  // 更新したデータをJSON形式に変換
  const updatedData = JsonData.stringify(jsonData);

  // data.jsonファイルに書き込む
  fs.writeFileSync('data.json', updatedData);

  console.log('JSONファイルの更新が完了しました。');
});

Lodashなどのライブラリを使用する

利点: 柔軟性が高い、様々な機能を利用できる
欠点: 習得コストがかかる

この方法は、Lodashなどのライブラリを使用して、JSONファイルを操作します。Lodashは、データ操作に役立つ様々なユーティリティ関数を提供しています。以下に例を示します。

const fs = require('fs');
const _ = require('lodash');

// data.jsonファイルを読み込む
fs.readFile('data.json', (err, data) => {
  if (err) {
    console.error(err);
    return;
  }

  // JSONデータを解析
  const jsonData = JSON.parse(data);

  // "name"プロパティの値を更新
  _.set(jsonData, 'name', 'Taro Yamada');

  // 更新したデータをJSON形式に変換
  const updatedData = JSON.stringify(jsonData);

  // data.jsonファイルに書き込む
  fs.writeFileSync('data.json', updatedData);

  console.log('JSONファイルの更新が完了しました。');
});