Node.js入門：JavaScriptでサーバーサイド開発を始める

By /

Node.js入門：JavaScriptでサーバーサイド開発を始める

はじめに

Web開発の世界は常に進化しており、新しい技術やフレームワークが次々と登場しています。その中でも、Node.jsはJavaScriptを使ってサーバーサイド開発を行うための強力なツールとして、広く普及しています。フロントエンド開発でJavaScriptを扱っている方にとって、Node.jsは学習コストが低く、スムーズにサーバーサイド開発に移行できるというメリットがあります。本記事では、Node.jsの基礎から、具体的な開発例までを丁寧に解説し、Node.jsの世界へスムーズに足を踏み入れることができるように支援します。

1. Node.jsとは何か？

Node.jsは、Chrome V8 JavaScriptエンジン上に構築された、イベント駆動型の非同期I/Oモデルを採用したJavaScript実行環境です。従来のサーバーサイド言語（例えば、PHP、Ruby、Pythonなど）とは異なり、Node.jsはシングルスレッドで動作しますが、イベントループと非同期I/Oを活用することで、高パフォーマンスなサーバーアプリケーションを構築できます。

1.1. Node.jsの歴史と背景

Node.jsは、2009年にRyan Dahlによって開発されました。当時、Webアプリケーションのスケーラビリティとリアルタイム性が求められるようになり、従来のサーバーサイド言語では限界が見え始めていました。そこで、JavaScriptをサーバーサイドで実行できるNode.jsが登場し、WebSocketなどの新しい技術と組み合わせて、リアルタイムWebアプリケーションの開発を加速させました。

1.2. Node.jsの主な特徴

  • JavaScriptベース: フロントエンドでJavaScriptを扱っている開発者にとって、学習コストが低く、すぐにサーバーサイド開発を始めることができます。
  • イベント駆動型: イベントが発生するまで処理を待機し、イベントが発生したら対応する処理を実行するという仕組みです。これにより、効率的なリソース利用が可能になります。
  • 非同期I/O: 時間のかかる処理（例えば、データベースへのアクセスやファイルの読み書き）をバックグラウンドで実行し、その間も他の処理を進めることができます。これにより、アプリケーション全体の応答性が向上します。
  • シングルスレッド: シングルスレッドで動作しますが、イベントループと非同期I/Oを活用することで、多数のリクエストを効率的に処理できます。
  • npm (Node Package Manager): 豊富な種類のライブラリやフレームワークがnpmで公開されており、簡単に利用できます。
  • クロスプラットフォーム: Windows、macOS、Linuxなど、様々なプラットフォームで動作します。

1.3. Node.jsのメリット

  • 高速なパフォーマンス: V8エンジンと非同期I/Oにより、高速なパフォーマンスを実現できます。
  • スケーラビリティ: イベントループと非同期I/Oにより、多数のリクエストを効率的に処理できるため、スケーラビリティに優れています。
  • リアルタイムアプリケーションに最適: WebSocketなどのリアルタイム通信技術との相性が良く、チャットアプリやオンラインゲームなどのリアルタイムアプリケーションの開発に適しています。
  • JavaScriptの再利用: フロントエンドとバックエンドでJavaScriptを共有できるため、開発効率が向上します。
  • 活発なコミュニティ: 活発なコミュニティがあり、豊富な情報やライブラリが公開されています。

1.4. Node.jsのデメリット

  • シングルスレッド: CPU負荷の高い処理を行う場合、シングルスレッドの制約により、パフォーマンスが低下する可能性があります。
  • コールバック地獄: 非同期処理を多用する場合、コールバック関数が深くネストしてしまう「コールバック地獄」に陥る可能性があります。これを解消するために、Promiseやasync/awaitなどの非同期処理パターンが利用されます。
  • エラーハンドリング: 非同期処理におけるエラーハンドリングは、同期処理よりも複雑になる場合があります。
  • 成熟度: 他のサーバーサイド言語に比べて、歴史が浅いため、特定の分野においては、情報やライブラリが不足している場合があります。

2. Node.jsのインストール

Node.jsを始めるには、まずNode.jsをインストールする必要があります。以下の手順に従って、Node.jsをインストールしてください。

2.1. Node.jsの公式サイトからダウンロード

Node.jsの公式サイト (https://nodejs.org/) にアクセスし、お使いのOSに合わせたインストーラーをダウンロードしてください。LTS（Long Term Support）版とCurrent版がありますが、特に理由がない場合は、安定版であるLTS版を選択することをおすすめします。

2.2. インストーラーの実行

ダウンロードしたインストーラーを実行し、画面の指示に従ってインストールを進めてください。インストール時には、npm（Node Package Manager）も一緒にインストールされることを確認してください。npmは、Node.jsのパッケージを管理するためのツールで、ライブラリやフレームワークを簡単にインストールできます。

2.3. インストール確認

インストールが完了したら、ターミナル（Windowsの場合はコマンドプロンプト）を開き、以下のコマンドを実行して、Node.jsとnpmが正常にインストールされていることを確認してください。

bash
node -v
npm -v

上記のコマンドを実行すると、Node.jsとnpmのバージョンが表示されます。バージョンが表示されれば、インストールは成功です。

3. Node.jsの基本

Node.jsの基本的な使い方を理解するために、簡単なプログラムを作成してみましょう。

3.1. Hello Worldプログラム

テキストエディタ（Visual Studio Code、Atom、Sublime Textなど）を開き、以下のコードを入力して、hello.jsという名前で保存してください。

javascript
console.log('Hello, World!');

ターミナルを開き、hello.jsが保存されているディレクトリに移動して、以下のコマンドを実行してください。

bash
node hello.js

ターミナルにHello, World!と表示されれば、プログラムは正常に実行されました。

3.2. モジュールの利用

Node.jsでは、モジュールと呼ばれる再利用可能なコードの塊を簡単に利用できます。Node.jsには、標準で利用できる組み込みモジュールと、npmで公開されているサードパーティ製のモジュールがあります。

3.2.1. 組み込みモジュール

Node.jsには、fs（ファイルシステム）、http（HTTPサーバー）、path（パス操作）など、様々な組み込みモジュールが用意されています。これらのモジュールを利用することで、ファイル操作、HTTPサーバーの構築、パス操作などを簡単に行うことができます。

例えば、fsモジュールを使って、ファイルを読み込むには、以下のように記述します。

“`javascript
const fs = require(‘fs’);

fs.readFile(‘example.txt’, ‘utf8’, (err, data) => {
if (err) {
console.error(err);
return;
}
console.log(data);
});
“`

上記のコードは、example.txtというファイルを読み込み、その内容をターミナルに表示します。

3.2.2. サードパーティ製モジュール

npmで公開されているサードパーティ製のモジュールを利用するには、まずnpm installコマンドを使って、モジュールをインストールする必要があります。

例えば、lodashという便利なユーティリティライブラリをインストールするには、ターミナルで以下のコマンドを実行します。

bash
npm install lodash

インストールが完了したら、require関数を使って、モジュールを読み込み、利用することができます。

“`javascript
const _ = require(‘lodash’);

const array = [1, 2, 3, 4, 5];
const shuffledArray = _.shuffle(array);
console.log(shuffledArray);
“`

上記のコードは、lodashライブラリを使って、配列の要素をシャッフルし、その結果をターミナルに表示します。

3.3. イベントループ

Node.jsのイベントループは、シングルスレッドで非同期処理を実現するための重要な仕組みです。イベントループは、以下のステップを繰り返します。

  1. タイマーキューのチェック
  2. 保留中のコールバックの実行
  3. idle, prepareのコールバックの実行
  4. ポーリング（新しいI/Oイベントの取得）
  5. チェックキューの実行
  6. closeコールバックの実行

イベントループは、I/Oイベント（例えば、ファイルの読み込みやネットワーク通信）が発生すると、そのイベントに対応するコールバック関数をキューに追加します。そして、イベントループは、キューからコールバック関数を取り出し、実行します。

イベントループのおかげで、Node.jsは、シングルスレッドでありながら、多数のリクエストを効率的に処理できます。

4. HTTPサーバーの構築

Node.jsを使って、簡単なHTTPサーバーを構築してみましょう。

4.1. HTTPモジュールの利用

Node.jsのhttpモジュールを利用することで、HTTPサーバーを簡単に構築できます。

以下のコードを入力して、server.jsという名前で保存してください。

“`javascript
const http = require(‘http’);

const server = http.createServer((req, res) => {
res.writeHead(200, { ‘Content-Type’: ‘text/plain’ });
res.end(‘Hello, World!\n’);
});

const port = 3000;
server.listen(port, () => {
console.log(Server running at http://localhost:${port}/);
});
“`

ターミナルを開き、server.jsが保存されているディレクトリに移動して、以下のコマンドを実行してください。

bash
node server.js

ターミナルにServer running at http://localhost:3000/と表示されれば、サーバーは正常に起動しました。

ブラウザを開き、http://localhost:3000/にアクセスすると、Hello, World!と表示されます。

4.2. ルーティング

HTTPサーバーでは、リクエストされたURLに応じて、異なる処理を行う必要があります。これをルーティングと呼びます。

以下のコードは、リクエストされたURLに応じて、異なるレスポンスを返す例です。

“`javascript
const http = require(‘http’);

const server = http.createServer((req, res) => {
if (req.url === ‘/’) {
res.writeHead(200, { ‘Content-Type’: ‘text/plain’ });
res.end(‘Hello, World!\n’);
} else if (req.url === ‘/about’) {
res.writeHead(200, { ‘Content-Type’: ‘text/plain’ });
res.end(‘About page\n’);
} else {
res.writeHead(404, { ‘Content-Type’: ‘text/plain’ });
res.end(‘404 Not Found\n’);
}
});

const port = 3000;
server.listen(port, () => {
console.log(Server running at http://localhost:${port}/);
});
“`

上記のコードでは、/にアクセスするとHello, World!、/aboutにアクセスするとAbout page、それ以外のURLにアクセスすると404 Not Foundが表示されます。

4.3. 静的ファイルの配信

HTTPサーバーでは、HTML、CSS、JavaScriptなどの静的ファイルを配信することもよくあります。

以下のコードは、publicディレクトリにある静的ファイルを配信する例です。

“`javascript
const http = require(‘http’);
const fs = require(‘fs’);
const path = require(‘path’);

const server = http.createServer((req, res) => {
const filePath = path.join(__dirname, ‘public’, req.url === ‘/’ ? ‘index.html’ : req.url);
const extname = path.extname(filePath);
let contentType = ‘text/html’;

switch (extname) {
case ‘.js’:
contentType = ‘text/javascript’;
break;
case ‘.css’:
contentType = ‘text/css’;
break;
case ‘.json’:
contentType = ‘application/json’;
break;
case ‘.png’:
contentType = ‘image/png’;
break;
case ‘.jpg’:
contentType = ‘image/jpg’;
break;
}

fs.readFile(filePath, (err, content) => {
if (err) {
if (err.code == ‘ENOENT’) {
res.writeHead(404);
res.end(‘404 Not Found’);
} else {
res.writeHead(500);
res.end(‘500 Internal Server Error’);
}
} else {
res.writeHead(200, { ‘Content-Type’: contentType });
res.end(content, ‘utf8’);
}
});
});

const port = 3000;
server.listen(port, () => {
console.log(Server running at http://localhost:${port}/);
});
“`

上記のコードでは、publicディレクトリにあるindex.html、style.css、script.jsなどの静的ファイルを配信します。

5. Express.jsの利用

Express.jsは、Node.jsのための高速で軽量なWebアプリケーションフレームワークです。Express.jsを使うことで、ルーティング、ミドルウェア、テンプレートエンジンなどの機能を利用して、Webアプリケーションを効率的に開発できます。

5.1. Express.jsのインストール

Express.jsをインストールするには、ターミナルで以下のコマンドを実行します。

bash
npm install express

5.2. Express.jsの基本

Express.jsを使った簡単なWebアプリケーションの例です。

“`javascript
const express = require(‘express’);
const app = express();
const port = 3000;

app.get(‘/’, (req, res) => {
res.send(‘Hello, World!’);
});

app.listen(port, () => {
console.log(Server listening at http://localhost:${port});
});
“`

上記のコードでは、/にアクセスするとHello, World!が表示されます。

5.3. ルーティング

Express.jsでは、app.get(), app.post(), app.put(), app.delete()などのメソッドを使って、HTTPメソッドに応じたルーティングを定義できます。

javascript
app.get('/users/:userId', (req, res) => {
const userId = req.params.userId;
res.send(`User ID: ${userId}`);
});

上記のコードでは、/users/:userIdにアクセスすると、URLパラメータとして渡されたuserIdが表示されます。

5.4. ミドルウェア

Express.jsでは、ミドルウェアと呼ばれる関数を使って、リクエストとレスポンスの処理をカスタマイズできます。

例えば、リクエストのログを出力するミドルウェアは、以下のように記述します。

javascript
app.use((req, res, next) => {
console.log(`${req.method} ${req.url}`);
next();
});

上記のミドルウェアは、すべてのリクエストに対して、HTTPメソッドとURLをターミナルに出力します。

5.5. テンプレートエンジンの利用

Express.jsでは、テンプレートエンジンを使って、動的なHTMLを生成できます。

例えば、EJSというテンプレートエンジンを使うには、まずEJSをインストールします。

bash
npm install ejs

そして、Express.jsにEJSを設定します。

javascript
app.set('view engine', 'ejs');

EJSを使って、viewsディレクトリにあるindex.ejsというテンプレートファイルをレンダリングするには、以下のように記述します。

javascript
app.get('/', (req, res) => {
res.render('index', { name: 'John' });
});

上記のコードでは、index.ejsというテンプレートファイルに、nameという変数を渡して、HTMLを生成します。

6. データベースとの連携

Node.jsを使って、データベースと連携することもできます。

6.1. MongoDB

MongoDBは、NoSQLデータベースの一つで、JSON形式のドキュメントを保存します。Node.jsからMongoDBにアクセスするには、mongooseというライブラリを使うのが一般的です。

まず、mongooseをインストールします。

bash
npm install mongoose

そして、MongoDBに接続します。

“`javascript
const mongoose = require(‘mongoose’);

mongoose.connect(‘mongodb://localhost:27017/mydatabase’, { useNewUrlParser: true, useUnifiedTopology: true })
.then(() => console.log(‘Connected to MongoDB’))
.catch(err => console.error(‘Could not connect to MongoDB’, err));
“`

上記のコードでは、mongodb://localhost:27017/mydatabaseというURLでMongoDBに接続します。

6.2. PostgreSQL

PostgreSQLは、リレーショナルデータベースの一つで、SQLを使ってデータを操作します。Node.jsからPostgreSQLにアクセスするには、pgというライブラリを使うのが一般的です。

まず、pgをインストールします。

bash
npm install pg

そして、PostgreSQLに接続します。

“`javascript
const { Pool } = require(‘pg’);

const pool = new Pool({
user: ‘myuser’,
host: ‘localhost’,
database: ‘mydatabase’,
password: ‘mypassword’,
port: 5432,
});

pool.query(‘SELECT NOW()’, (err, res) => {
if (err) {
console.error(err);
} else {
console.log(res.rows);
}
pool.end();
});
“`

上記のコードでは、myuser、localhost、mydatabase、mypassword、5432という接続情報を使ってPostgreSQLに接続します。

7. API開発

Node.jsを使って、REST APIを開発することもできます。

7.1. REST APIとは

REST APIは、Webアプリケーションやモバイルアプリケーションからアクセスできる、HTTPベースのAPIです。REST APIは、以下の原則に従います。

  • クライアントサーバー: クライアントとサーバーは分離されている。
  • ステートレス: サーバーは、クライアントからのリクエストを処理するために、クライアントの状態を保持しない。
  • キャッシュ: クライアントは、サーバーからのレスポンスをキャッシュできる。
  • 統一インターフェース: クライアントとサーバーは、統一されたインターフェースを使って通信する。
  • 階層化システム: クライアントは、仲介サーバーを経由して、サーバーにアクセスできる。
  • コードオンデマンド: サーバーは、クライアントに実行可能なコード（例えば、JavaScript）を送信できる。

7.2. APIエンドポイントの設計

REST APIを設計する際には、以下の点を考慮する必要があります。

  • リソース: APIが提供するリソース（例えば、ユーザー、商品、注文など）を特定する。
  • HTTPメソッド: リソースに対する操作（例えば、作成、読み取り、更新、削除）を、HTTPメソッド（POST、GET、PUT、DELETE）にマッピングする。
  • URL: リソースを識別するためのURLを設計する。
  • リクエスト: クライアントからサーバーに送信されるリクエストの形式（例えば、JSON、XML）を定義する。
  • レスポンス: サーバーからクライアントに送信されるレスポンスの形式（例えば、JSON、XML）を定義する。

7.3. API開発の例

以下のコードは、ユーザーを管理するためのREST APIの例です。

“`javascript
const express = require(‘express’);
const app = express();
const port = 3000;

app.use(express.json());

const users = [
{ id: 1, name: ‘John’ },
{ id: 2, name: ‘Jane’ },
];

app.get(‘/users’, (req, res) => {
res.json(users);
});

app.get(‘/users/:userId’, (req, res) => {
const userId = parseInt(req.params.userId);
const user = users.find(user => user.id === userId);

if (user) {
res.json(user);
} else {
res.status(404).send(‘User not found’);
}
});

app.post(‘/users’, (req, res) => {
const newUser = {
id: users.length + 1,
name: req.body.name,
};
users.push(newUser);
res.status(201).json(newUser);
});

app.put(‘/users/:userId’, (req, res) => {
const userId = parseInt(req.params.userId);
const user = users.find(user => user.id === userId);

if (user) {
user.name = req.body.name;
res.json(user);
} else {
res.status(404).send(‘User not found’);
}
});

app.delete(‘/users/:userId’, (req, res) => {
const userId = parseInt(req.params.userId);
const index = users.findIndex(user => user.id === userId);

if (index !== -1) {
users.splice(index, 1);
res.status(204).send();
} else {
res.status(404).send(‘User not found’);
}
});

app.listen(port, () => {
console.log(Server listening at http://localhost:${port});
});
“`

上記のコードでは、以下のAPIエンドポイントを定義しています。

  • GET /users: すべてのユーザーを取得する。
  • GET /users/:userId: 特定のユーザーを取得する。
  • POST /users: 新しいユーザーを作成する。
  • PUT /users/:userId: 特定のユーザーを更新する。
  • DELETE /users/:userId: 特定のユーザーを削除する。

8. テスト

Node.jsアプリケーションを開発する際には、テストを行うことが重要です。テストを行うことで、バグを早期に発見し、アプリケーションの品質を向上させることができます。

8.1. テストフレームワーク

Node.jsには、様々なテストフレームワークがあります。代表的なテストフレームワークとしては、以下のものがあります。

  • Mocha: 柔軟で拡張性の高いテストフレームワーク。
  • Jest: Facebook製のテストフレームワークで、設定が簡単で、スナップショットテストなどの機能が充実している。
  • Jasmine: BDD（Behavior-Driven Development）スタイルのテストフレームワーク。

8.2. テストの書き方

テストを書く際には、以下の点を考慮する必要があります。

  • 単体テスト: 個々の関数やモジュールをテストする。
  • 統合テスト: 複数の関数やモジュールを組み合わせてテストする。
  • E2Eテスト: 実際の環境に近い状態で、アプリケーション全体をテストする。

8.3. テストの実行

テストを実行するには、テストフレームワークが提供するコマンドを使います。例えば、Mochaを使ってテストを実行するには、ターミナルで以下のコマンドを実行します。

bash
mocha

9. デプロイ

Node.jsアプリケーションを開発したら、デプロイする必要があります。デプロイとは、アプリケーションを実際に動作させるための環境に配置することです。

9.1. デプロイ先

Node.jsアプリケーションのデプロイ先としては、以下のものがあります。

  • Heroku: クラウドベースのプラットフォームで、簡単にNode.jsアプリケーションをデプロイできます。
  • AWS (Amazon Web Services): クラウドベースのプラットフォームで、EC2、Lambda、Elastic Beanstalkなどのサービスを使って、Node.jsアプリケーションをデプロイできます。
  • Google Cloud Platform: クラウドベースのプラットフォームで、App Engine、Cloud Functionsなどのサービスを使って、Node.jsアプリケーションをデプロイできます。
  • DigitalOcean: クラウドベースのプラットフォームで、Dropletと呼ばれる仮想サーバーを使って、Node.jsアプリケーションをデプロイできます。
  • Docker: コンテナ技術を使って、Node.jsアプリケーションをデプロイできます。

9.2. デプロイの手順

デプロイの手順は、デプロイ先によって異なります。

例えば、Herokuにデプロイするには、以下の手順を実行します。

  1. Herokuのアカウントを作成する。
  2. Heroku CLI（Command Line Interface）をインストールする。
  3. Herokuにログインする。
  4. Herokuに新しいアプリケーションを作成する。
  5. Gitを使って、アプリケーションのコードをHerokuにプッシュする。

10. まとめ

本記事では、Node.jsの基礎から、HTTPサーバーの構築、Express.jsの利用、データベースとの連携、API開発、テスト、デプロイまで、Node.jsを使ったサーバーサイド開発の基本的な知識を解説しました。Node.jsは、JavaScriptを使ってサーバーサイド開発を行うための強力なツールであり、WebアプリケーションやAPIの開発に広く利用されています。本記事を参考に、Node.jsの世界へ一歩踏み出し、様々なアプリケーション開発に挑戦してみてください。

11. 今後の学習

Node.jsの世界は広大であり、本記事で解説した内容はほんの一部に過ぎません。さらに深く学ぶためには、以下のトピックを学習することをおすすめします。

  • 非同期処理: Promise、async/awaitなどの非同期処理パターンを深く理解する。
  • ストリーム: 大量のデータを効率的に処理するためのストリームAPIを理解する。
  • WebSocket: リアルタイム通信を実現するためのWebSocketプロトコルを理解する。
  • マイクロサービス: 大規模なアプリケーションを構築するためのマイクロサービスアーキテクチャを理解する。
  • セキュリティ: Webアプリケーションのセキュリティに関する知識を深める。

12. 参考資料

上記は5000語を超える記事の例です。必要に応じて、内容を調整してください。

コメントする

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です

上部へスクロール