React 入門

JavaScript コメント掲示板アプリの開発

WebStorage の利用

ここまでの作業でコメントの一覧表示，新規投稿，削除の作業をページの遷移を伴うことなく（つまり同じ URL で）できるようになりました．しかし，ブラウザで再読み込みボタンをクリックすると初期状態に戻ってしまいます．ここでは WebStorage を使ってブラウザ内にコメント情報を保存する方法を示します．これによって，ブラウザを閉じたり，再読み込みをしてもデータが保持されるようになります．なお，WebStorage の詳細は MDN を参照してください．

まず，ブラウザで WebStorage の内容を確認する方法について説明します．Google Chrome では DevTools で「Application」の「Storage」にある「Local storage」と「Session storage」を参照することでブラウザに保存された情報を確認したり，編集，削除ができます．

useState で管理しているコメントの情報を WebStorage に保存することを考えます．例えばコメントの追加処理を行うタイミングで WebStorage に保存するとよいでしょう．したがって，CommentListPage.js の追加処理に WebStorage にも保存するコードを追加します．WebStorage には「キー」と「値（文字列）」のペアで保存します．このとき，newResults はオブジェクト形式であるので，文字列形式に変換するために JSON.stringify() 関数を利用しています．

src/components/CommentListPage.js（抜粋）
const handelCreateFormSubmit = (title, body) => {
  const newComments = [...results.results];  // スプレッド構文でコメントの配列だけを取り出す
  newComments.unshift({   // unshift で先頭に追加，push では最後に追加
    id: Date.now(),
    title: title,
    body: body,
    updated_at: "2024-02-25T15:30:00",
  });
  const newResults = {
    "count": results.count + 1, // コメント数は1増やす
    "previous": results.previous,
    "next" : results.next,
    "results": newComments,   // これがコメントの配列
  };
  setResults(newResults); // 画面を更新
  // WebStorageに保存
  localStorage.setItem('results', JSON.stringify(newResults));
}

ブラウザでコメントを投稿した後に WebStorage の内容を確認します．「results」をキーとしてコメントの情報が JSON 形式の文字列として格納されていることがわかります．

追加時に WebStorage へ保存できたので，削除したときにも WebStorage へ保存します．

src/components/CommentListPage.js（抜粋）
const handleDeleteButtonClick = (commentId) => {
  if (!window.confirm("削除しますか？")) {
    return;
  }
  const newComments = [...results.results].filter((comment) => {
    return comment.id !== commentId;
  });
  const newResults = {
    "count": results.count - 1, // コメント数は1減らす
    "previous": results.previous,
    "next" : results.next,
    "results": newComments
  };
  setResults(newResults);
  // WebStorageに保存
  localStorage.setItem('results', JSON.stringify(newResults));
};

コメントの追加と削除時に WebStorage へ保存されることを確認しました．現時点ではブラウザを再読み込みしたときには初期状態に戻ってしまいます．最後にブラウザを再読込したり，再起動したときに WebStorage へ保存されたコメント情報が表示されるようにします．このためにはページが再読込されたときだけ WebStorage からデータを読み出したいので，useEffect を使います．まず，プログラムの先頭で useEffect をインポートします．

src/components/CommentListPage.js（抜粋）
import { useState, useEffect } from 'react';

ページの再読込時だけ処理を実行したいので，useEffect の第2引数には空配列 [] を渡します．

src/components/CommentListPage.js（抜粋）
useEffect(() => {実行したい処理}, []);

実行したい処理，つまり WebStorage からの読み込みとデータの更新作業を上の { ... } の中に入力します．このとき，WebStorage に「results」キーが存在しない場合の処理も記載していることに注意してください．キーが存在した場合には文字列形式のデータを JSON.parse() によってオブジェクト形式に変換しています．

src/components/CommentListPage.js（抜粋）
useEffect(() => {
  let localResults;
  if (localStorage.getItem('results') === null) {
    localResults = results;    // 存在しない場合には初期値を設定
  } else {
    localResults = JSON.parse(localStorage.getItem('results'));
  }
  setResults(localResults);
}, []);

ページの再読込時に WebStorage の内容が表示されることを確認してください．なお，WebStorage の LocalStorage はブラウザごとに保存され，有効期限はありません．ブラウザや OS を再起動しても同じブラウザであれば保存された内容が毎回読み出されます．SessionStorage では1セッションのデータのみを保存するので，ブラウザを再起動した場合や，新たなタブを開いた場合にはその情報が利用されません．

ローカルで完結するシステムであればこの段階でほぼ完成です．次のページではバックエンドの API サーバに接続して API からコメントの一覧を取得したり，投稿したりするフロントエンドを React で作成します．次のページに進んで作業を継続する場合はこのページで追加した WebStorage に関する部分を削除するかコメントアウトするかして，前のページの状態に戻しておいてください．

目次に戻る