Node.js で Express フレームワークを使って Cookie を設定する方法

2024-04-18

Node.js で Express フレームワークを使って Cookie を設定する方法

Cookie は、Web アプリケーションとクライアントブラウザ間でデータを保存するために使用される小さなデータです。ログイン情報、ユーザー設定、トラッキングデータなどを保存するために使用できます。

Express は、Node.js で最も人気のある Web フレームワークの 1 つであり、Cookie を設定するための使いやすい機能を提供しています。

必要なもの

このチュートリアルを完了するには、以下のものが必要です。

Node.js がインストールされているコンピュータ
テキストエディタまたは IDE

手順

プロジェクトを作成する

まず、新しい Node.js プロジェクトを作成する必要があります。これを行うには、次のコマンドを実行します。
```
npm init -y
```
次に、Express フレームワークをインストールします。
```
npm install express
```
Cookie を設定する

Express で Cookie を設定するには、res.cookie() メソッドを使用します。このメソッドには、Cookie の名前、値、オプション (有効期限、パスなど) を引数として渡します。

以下の例は、count という名前の Cookie を設定する方法を示しています。この Cookie は、ユーザーがサイトを訪問した回数をカウントします。
```
const express = require('express');
const app = express();

app.get('/', (req, res) => {
  let count = req.cookies.count || 0;
  count++;
  res.cookie('count', count);
  res.send('Hello World! You have visited this site ' + count + ' times.');
});

app.listen(3000, () => {
  console.log('Server started on port 3000');
});
```
このコードを実行すると、ブラウザで http://localhost:3000 にアクセスすると、Hello World! You have visited this site 1 time. というメッセージが表示されます。ブラウザを再読み込みすると、カウントが 2 になります。
Cookie のオプション

res.cookie() メソッドには、Cookie の動作を制御するオプションをいくつか指定できます。
- expires: Cookie の有効期限を Date オブジェクトとして設定します。
- maxAge: Cookie の有効期限をミリ秒単位で設定します。
- path: Cookie が有効なパスを設定します。
- secure: Cookie が HTTPS 接続でのみ送信されるように設定します。
- httpOnly: Cookie が JavaScript からアクセスできないように設定します。
以下の例は、expires オプションを使用して、Cookie を 1 日間保持する方法を示しています。
```
res.cookie('count', count, { expires: new Date(Date.now() + 86400000) });
```

Express を使用して Node.js で Cookie を設定することは、簡単で straightforward な作業です。上記の手順に従うことで、アプリケーションで Cookie を簡単に利用することができます。

例 1: 基本的な Cookie 設定

const express = require('express');
const app = express();

app.get('/', (req, res) => {
  let count = req.cookies.count || 0;
  count++;
  res.cookie('count', count);
  res.send('Hello World! You have visited this site ' + count + ' times.');
});

app.listen(3000, () => {
  console.log('Server started on port 3000');
});

例 2: Cookie オプションの指定

const express = require('express');
const app = express();

app.get('/', (req, res) => {
  let count = req.cookies.count || 0;
  count++;
  res.cookie('count', count, { expires: new Date(Date.now() + 86400000) });
  res.send('Hello World! You have visited this site ' + count + ' times.');
});

app.listen(3000, () => {
  console.log('Server started on port 3000');
});

説明

express = require('express'): Express フレームワークをインポートします。
app = express(): Express アプリケーションを作成します。
app.get('/', (req, res) => {...}): / パスへの GET リクエストを処理するルートハンドラーを定義します。
req.cookies.count: リクエストの Cookie オブジェクトから count Cookie の値を取得します。
count++: Cookie の値を 1 増やします。
res.cookie('count', count): count という名前の Cookie に新しい値を設定します。
res.send('Hello World! You have visited this site ' + count + ' times.'): ユーザーにメッセージを送信します。
app.listen(3000, () => {...}): サーバーをポート 3000 で起動します。

実行方法

このコードを実行するには、次の手順に従います。

```
node app.js
```

補足

このコードは、基本的な Cookie の設定方法のみを示しています。Cookie には、より多くのオプションと機能があります。詳細については、Express の Cookie ドキュメントを参照してください。
このコードは、セキュリティ上の考慮事項を考慮していません。本番環境で Cookie を使用する場合は、適切なセキュリティ対策を講じてください。

Express で Cookie を設定するその他の方法

サイン付き Cookie は、改ざん防止機能を備えた Cookie です。これらは、Cookie の値を暗号化して、サーバーのみで復号化できるようにすることで実現されます。

Express で署名付き Cookie を設定するには、express-session ミドルウェアを使用する必要があります。このミドルウェアは、セッション管理と署名付き Cookie のサポートを提供します。

以下の例は、express-session を使用して署名付き Cookie を設定する方法を示しています。

const express = require('express');
const session = require('express-session');

const app = express();

app.use(session({
  secret: 'my secret key',
  resave: false,
  saveUninitialized: true
}));

app.get('/', (req, res) => {
  req.session.count = req.session.count || 0;
  req.session.count++;
  res.send('Hello World! You have visited this site ' + req.session.count + ' times.');
});

app.listen(3000, () => {
  console.log('Server started on port 3000');
});

HTTP ヘッダー

Cookie 以外にも、HTTP ヘッダーを使用してクライアントにデータを保存することもできます。

たとえば、Set-Cookie ヘッダーを使用して Cookie を設定できます。

const express = require('express');
const app = express();

app.get('/', (req, res) => {
  res.setHeader('Set-Cookie', 'count=1');
  res.send('Hello World!');
});

app.listen(3000, () => {
  console.log('Server started on port 3000');
});