はじめに
「Node.jsは触ったことがあるけれど、イベントループや非同期の仕組みを説明しろと言われると怪しい」。そんな状態を抜け出したくて、『ハンズオンNode.js』(今村 謙士 著、オライリー・ジャパン)を通読しました。
結論から言うと、本書は**「APIの使い方」ではなく「Node.jsという技術の設計思想」を、手を動かしながら腹落ちさせてくれる一冊**です。設計やアーキテクチャに関心のあるエンジニアほど、得るものが大きいと感じました。
この記事では、章ごとの内容を要約しつつ、設計の観点で印象に残ったポイントと、読む前に知っておきたい注意点をまとめます。
本記事は書籍の要約・書評です。内容は私の理解に基づいて言い換えており、コードも説明用に書き起こしたものです。正確な記述やサンプルコードは書籍をご確認ください。
書籍情報
| 項目 | 内容 |
|---|---|
| 書名 | ハンズオンNode.js |
| 著者 | 今村 謙士 |
| 出版社 | オライリー・ジャパン |
| 初版 | 2020年11月 |
| 動作確認環境 | Node.js v14.13.0(Windows / macOS) |
| 想定読者 | 他言語の経験はあるがNode.jsは未経験、または初心者 |
本書の立ち位置
本書の特徴は、まえがきで次の方針がはっきり示されている点です。
- Node.jsの機能やAPIを網羅する本ではない
- 「どんな特徴を持つ技術か」「どんなアプリに向くか」にフォーカスする
- 特徴を活かす実装パターンを身につける
- 典型的なユースケースで開発・テスト・デプロイまで一通り実践する
逆に、認証やセキュリティ、大規模アプリの設計パターンなど、発展的な話題は意図的に扱っていません。「基本を深く掘る代わりに、広げすぎない」という割り切りが、読後の納得感につながっています。
全体構成
前半(1〜4章)で言語・並行処理モデルの土台を作り、中盤(5〜9章)でToDo管理アプリを育てながら「作る・保存する・テストする・公開する」を体験し、後半(10〜11章)でエコシステムと標準仕様に視野を広げる流れです。
章ごとのレビュー
1章 イントロダクション
Node.jsの特徴が、キーワードごとに整理されています。
- イベントループによる並行処理(コンビニのレジの例えが秀逸です)
- スモールコアとnpm(コアは最小限、機能はエコシステムに委ねる)
- モジュールシステム(CommonJSと、UNIX哲学に基づくモジュール設計の指針)
- ユニバーサルJavaScript(サーバとクライアントでコードを共有できる)
さらに、ECMAScript標準とWeb標準の関係、REPLの使い方、最低限のJavaScript文法(const/let、クラス、プロトタイプチェーン、===、CommonJS、strictモード)まで、2章以降の前提がここでそろいます。
設計の視点では、「スモールコア」と「UNIX哲学」がNode.jsの文化の根っこにあると説明されている点が重要でした。以降の章で出てくるAPIの形が、この思想の延長で理解できるようになります。
2章 非同期プログラミング
本書の中でも最も分量が多く、読みごたえがある章です。流れは次のとおりです。
- マルチスレッドの問題点(C10K問題、スレッドセーフ、デッドロック)
- イベントループとノンブロッキングI/O
- コールバックとエラーハンドリング、コールバックヘル
- Promise(状態遷移、
then/catch/finally、並行実行の静的メソッド) - ジェネレータとasync/await
特に印象に残ったのは、次の3点です。
① マルチスレッドとの比較が「簡潔さ vs 柔軟さ」のトレードオフとして語られる
どちらが優れているかではなく、並行処理をコードで表現する必要があるかどうかの違いとして整理されています。この見方のおかげで、Node.jsの得意・不得意(I/O負荷が高い処理は得意、CPU負荷が高い処理は注意が必要)が自然に理解できます。
② 「混ぜるな危険、同期と非同期」
コールバックを受け取る関数は、常に同期で呼ぶか、常に非同期で呼ぶかのどちらかに統一するべきだという原則です。たとえば、キャッシュがあるときだけ同期的にコールバックを呼ぶ関数は、呼び出し側の実行順序を予測しづらくします。
// アンチパターンの例(説明用)
function getUser(id, callback) {
if (cache.has(id)) {
return callback(null, cache.get(id)) // キャッシュ時だけ同期で呼ばれる
}
fetchUser(id, (err, user) => {
if (!err) cache.set(id, user)
callback(err, user) // 通常は非同期で呼ばれる
})
}
// 改善例: キャッシュ時も非同期に揃える
function getUserFixed(id, callback) {
if (cache.has(id)) {
return process.nextTick(() => callback(null, cache.get(id)))
}
fetchUser(id, (err, user) => {
if (!err) cache.set(id, user)
callback(err, user)
})
}
本書では、process.nextTick()やqueueMicrotask()がイベントループのフェーズとどう関係するのかまで踏み込んで説明されており、単なる「おまじない」で終わらないのが良い点です。
③ Promiseの静的メソッドを「ショートサーキット条件」で分類する
Promise.all()、race()、allSettled()、any()を、「どの条件で早期に確定するか」という一つの軸で整理しています。名前だけでは挙動を思い出しにくいメソッド群が、この表で一気に整理できました。
| メソッド | 早期に確定する条件 |
|---|---|
Promise.all() |
1つでも拒否されたとき |
Promise.race() |
1つでも確定したとき |
Promise.allSettled() |
早期確定しない |
Promise.any() |
1つでも成功したとき |
// 独立した処理は並行実行したほうが速い(説明用)
const wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms))
async function sequential() {
await wait(1000)
await wait(1000) // 合計 約2秒
}
async function parallel() {
await Promise.all([wait(1000), wait(1000)]) // 合計 約1秒
}
3章 EventEmitterとストリーム
「1回の要求に対して結果が複数回返ってくる非同期処理」を扱う章です。Promiseは一度確定したら状態が変わらないため、この種の処理には向きません。そこで登場するのが次の2つです。
- EventEmitter: Observerパターンの実装。直接使う方法と継承して使う方法
- ストリーム: 読み込み、書き込み、二重、変換の4種類
実装を通じて、バックプレッシャ(書き込み側が追いつかないときに読み込みを止める仕組み)や、pipe()とstream.pipeline()の違い、stream.finished()による完了処理、asyncイテラブルとの互換性まで学べます。
const fs = require('fs')
const zlib = require('zlib')
const { pipeline } = require('stream')
// pipeline はエラー伝播と後始末をまとめて面倒見てくれる(説明用)
pipeline(
fs.createReadStream('app.log'),
zlib.createGzip(),
fs.createWriteStream('app.log.gz'),
(err) => {
if (err) console.error('失敗', err)
else console.log('圧縮完了')
}
)
ストリームはNode.jsコアの至るところで使われているインタフェースなので、ここで基本を押さえておくと他のAPIの理解も早くなります。
4章 マルチプロセス、マルチスレッド
イベントループはシングルスレッドで動くため、マルチコアを活かすには工夫が必要です。本章では2つの手段を学びます。
- cluster: マルチプロセス化。特別な実装なしにポートを共有でき、IPCでメッセージをやりとりできる
- worker_threads: マルチスレッド。メッセージ通信は構造化クローンが基本で、値の転送や共有、共有値をスレッドセーフに更新する仕組みも提供される
// cluster の最小構成(説明用)
const cluster = require('cluster')
const http = require('http')
const os = require('os')
if (cluster.isMaster) { // v16以降は cluster.isPrimary
os.cpus().forEach(() => cluster.fork())
} else {
http.createServer((req, res) => res.end('ok')).listen(3000)
}
2章で「CPU負荷の高い処理には注意が必要」と指摘した問題に、4章がきちんと答えを出してくれる構成になっています。章をまたいだ伏線回収が気持ちよく、Node.jsは「シングルスレッドだから限界がある」わけではないとはっきり言い切れるようになりました。
5章 HTTPサーバとHTTPクライアント
ここからはToDo管理アプリケーションを題材に、実践的な内容に入ります。
- コアの
httpモジュールによるサーバ・クライアント実装 - Express(ルーティング、ミドルウェア)
- Next.jsによるユニバーサルWebアプリケーション
スモールコアの哲学どおり、httpモジュールは低レベルなAPIです。そのため実開発ではラップしたライブラリを使うことが多い、という現実的な説明がされています。「まず低レベルを知り、そのうえで高レベルのライブラリを使う」順序が、設計理解の面で効果的でした。
6章 リアルタイムWebアプリケーション
サーバの状態変化をクライアントへ即座に反映するための手段を、4つ比較しています。
| 方式 | ひとこと |
|---|---|
| ポーリング | 定期的に問い合わせる。単純だが無駄が多い |
| ロングポーリング | 変化があるまで応答を待たせる |
| SSE | サーバからクライアントへの一方向ストリーム |
| WebSocket | 双方向通信(本書ではSocket.IOなどで実装) |
最後は「要件に合わせて選びましょう」と締められます。技術選定の判断軸を学べる章として、アーキテクチャに関心のある方におすすめです。
7章 データストレージ
ToDo一覧をメモリ上で持っていたこれまでの実装を、永続化する章です。ファイルシステム、リレーショナルデータベース、NoSQLを順に扱います。
印象的だったのは、データストレージの操作を抽象化し、それ以外のコードを使い回す設計になっていることです。ストレージを差し替えても影響範囲が小さく、「関心の分離」を実コードで体験できます。プレースホルダ(動的・静的)についての言及もあり、SQLを扱ううえでの基本的な注意点も押さえられます。
8章 ユニットテストとデバッグ
テストピラミッドの考え方から入り、ユニットテストのツール構成を2パターンで実践します。
- Mocha + Chai + Sinon.JS + Istanbul の組み合わせ
- Jest 単体
加えて、Node.js標準のインスペクタを使ったデバッグ方法も紹介されています。「ツールを組み合わせる構成」と「オールインワン」を同じ題材で比較できるため、自分のプロジェクトでの選定にも使えます。
9章 デプロイ
デプロイ手段を大きく3つに分けて整理しています。
- npmパッケージとして提供されるデプロイツール(主にオンプレミス向け)
- コンテナ技術(Docker)
- クラウドサービス(PaaS、FaaS、BaaSといった分類)
「サーバレス」を「サーバという単位を意識しない開発」と説明するなど、用語の整理が丁寧です。どの選択肢が自分の案件に合うかを考える足がかりになります。
10章 パッケージ管理
npm(v6、v7)とYarn(1、2)の使い方、そしてpackage.jsonに書くメタデータを扱います。JavaScript開発ではNode.jsを使うかどうかにかかわらず必要になる知識であり、今なお進化している領域だという点にも触れられています。
11章 Node.jsとJavaScript標準
標準仕様がNode.jsに入ってくる過程を、2つの事例で読み解きます。
- ESモジュール: CommonJSで始まったNode.jsに導入する難しさ。二重パッケージの危険性にも注意が必要
- WebAssembly: V8経由で利用可能になり、WASIなども実験的にサポート
さらに、フェッチAPIがなぜすぐには導入できないのか(依存する他のWeb標準、セキュリティ要件の違い)が語られます。標準化の議論を追うことが技術の未来を読む手がかりになる、という視点は、設計に関わる人にとって示唆的でした。
付録
- 付録A: OSごとのインストール手順
- 付録B: BabelやTypeScriptなどのコンパイルの仕組み
- 付録C: 各章の練習問題の解答
練習問題は、5〜8章で作るToDoアプリを少しずつ拡張していく形式になっています。解答があるので、自習でも答え合わせができます。
設計・アーキテクチャ視点で刺さったポイント
通読して、設計の観点で特に持ち帰りたいと思った点を5つ挙げます。
- 並行処理モデルの選択はトレードオフである: 簡潔さを取るか、柔軟さとスケーラビリティを取るか
- 一貫性のあるAPI設計: コールバックを同期・非同期で混在させない
- 小さく作って組み合わせる: スモールコアとUNIX哲学が、モジュール設計の指針になる
- 責務の抽象化: ストレージ操作を切り離すことで、残りのコードを再利用できる
- 選択肢を比較する姿勢: リアルタイム通信、テスト構成、デプロイ手段のいずれも「要件に合わせて選ぶ」と明言される
これらは、Node.js以外の言語・基盤でも通用する考え方です。
気になった点・注意点
良い本ですが、読む前に知っておきたい点もあります。
本書は2020年刊行で、Node.js v14を前提に書かれています。現在のバージョンとは差があるため、公式ドキュメントとあわせて読むことをおすすめします。
- ESモジュールの扱いが当時の状況: 執筆時点では実験的機能だったため、本文はCommonJS中心です。現在はESモジュールを前提にする場面も増えています(11章の背景理解には今でも有用です)
-
Promise.any()などの記述: 当時は未対応だった機能が「将来使えるはず」という形で説明されています - フェッチAPIの状況: 11章で「導入は難しい」と語られていますが、その後の状況は変わっている可能性があるため、最新情報の確認が必要です
- セキュリティや大規模設計は対象外: 認証や大規模アプリの設計パターンは扱いません。次の一冊が必要です
とはいえ、これらはバージョンの差であって、イベントループや非同期、ストリームといった本質的な部分の価値は古びていません。
こんな方におすすめです
| 向いている | 向いていない |
|---|---|
| 他言語経験者でNode.jsを体系的に学びたい | プログラミング自体が初めての方 |
| 非同期処理を「なんとなく」から卒業したい | 最新バージョンの全APIを網羅的に知りたい方 |
| 技術選定の判断軸を養いたい | 認証・セキュリティを深く学びたい方 |
| 手を動かして理解するタイプ | 読み物として流し読みしたい方 |
プログラミング自体が初めての方には、本書でも姉妹書の『ハンズオンJavaScript』が案内されています。
読み方のコツ
- REPLで必ず手を動かす: 1章でREPLの使い方を学べるので、以降は実際に打ち込みながら読むと理解が段違いです
- 2章は時間をかける: 本書の核なので、焦らず進めましょう
- 練習問題を解く: ToDoアプリの拡張を通じて、5〜8章の知識が定着します
- 現行バージョンで試す: サンプルを現在のNode.jsで動かし、差分を調べると、より深い学びになります
まとめ
『ハンズオンNode.js』は、Node.jsを**「なぜそう動くのか」から理解させてくれる入門書**です。
- イベントループと非同期プログラミングを、設計思想から丁寧に解説している
- ToDoアプリを育てながら、開発・テスト・デプロイまで一貫して体験できる
- 技術選定の判断軸が随所に示されている
- 刊行時期の都合でバージョン差はあるが、本質的な内容は色あせていない
「Node.jsを使ってはいるが、根っこの部分が曖昧」というエンジニアにこそ、読んでほしい一冊です。