Litmus — 話題のニュースを、深く読み解く。 RSS
ソフトウェア

OpenVesselでNode.js環境をブラウザだけで完結させる

神戸ソフトのOSS「OpenVessel」は、Node.jsを書き換えずにブラウザのタブ内で動かす。npm installからAstroのビルド・プレビューまでサーバー無しで完結し、本家の試験1,516本に全数合格した。

コンピューターの画面に映るHTMLコードのクローズアップ(イメージ写真)

イメージ写真 記事の内容を撮影したものではありません。Photo by Markus Spiske on Pexels

この記事には Amazon アソシエイトのリンクを含みます。

チュートリアルサイトやオンラインエディタを作るとき、読者や受講者ごとにNode.jsをインストールしてもらうのは地味に重い。バージョンが揃わなかったり、npm installがPCごとに違う結果になったりして、手順書どおりに進まない人が必ず出る。かといってサーバー側に1人分ずつコンテナを立てるのも、費用と管理の手間が増える。

神戸ソフト株式会社が公開したオープンソース「OpenVessel」は、この二択を避ける第三の道だ。ブラウザのタブを開くだけで、本物のNode.jsとnpmが動く。npm installからAstroサイトのビルド・開発サーバー・プレビューまで、サーバーを一切使わずにタブの中だけで完結する。

「本物の」と言い切っていいのか。ブラウザの中で動く以上、どこかで本家Node.jsと妥協しているのではないか。その疑いから確かめていく。

Node.jsは本物のまま動いているか

公式GitHubリポジトリのREADMEによれば、OpenVesselはNode.js v26のlib/を一切書き換えずに動かす。lib/は、Node.js自身が書いているJavaScriptの部分だ。

Node.jsは普段、このlib/の下にC++で書かれたモジュールを持つ。internalBinding()と呼ばれ、ファイル操作・通信・タイマー・暗号など約50個ある。OpenVesselが新しく実装したのは、このinternalBinding()の部分だけだ。TypeScriptで書き直し、小さなカーネルの上に載せている。

ネイティブバイナリで配布されるパッケージ(esbuild・rollup・sharpなど)はWebAssembly版に差し替わる。WebAssembly版が存在しないパッケージには、OpenVessel自身が用意した互換パッケージ(Pagefindなど)が使われる。

公式ドキュメントは、この「JavaScript部分はそのまま」という設計の裏付けを示している。Node.js自身の公式テストスイートを、OpenVesselの上で走らせた結果だ。対象1,563本のうち、ブラウザで実行できる1,516本すべてに合格(100%)したという。

ここで自分は、今日見つけたPublickeyの紹介記事の数字と食い違っていることに気づいた。同記事は「1,237本すべてに合格」と書いている。どちらも嘘ではない。1,237本は2026年10月25日公開の初版v1.0.0(Node.js v22.23.4)での数字だ。

2026年11月3日公開のv2.0.0でNode.js 26への移行が終わり、合格数は1,516本まで増えている。最初はテスト数が減ったのかと身構えたが、実際には対応バージョンが上がって対象自体が増え、そのうえで全数合格を保っていた。「書き換えていない」という主張の中身は分かった。次に気になるのは、その主張がどうやって成り立っているかだ。

なぜ同期処理がブラウザで動くのか

Node.jsのプログラムには、const data = fs.readFileSync('config.json')のような書き方がよく出てくる。処理が終わるまで、その場で待つ書き方だ。ブラウザはもともとシングルスレッドで、こういう「待つ」処理を前提にしていない。それなのに、なぜOpenVesselの上でこの1行がそのまま動くのか。

答えは、ブラウザが元から持つ機能の組み合わせにある。公式ドキュメント「How it works」によれば、OpenVesselはWeb Workerを2種類の役に割り当てる。1つがOS役の「カーネル」で、ファイルシステムやプロセスの管理を担う。もう1つが、起動したnodeプロセスそのもので、プロセス1つにつきWeb Workerが1つ割り当てられる。

fs.readFileSyncが呼ばれると、プロセス役のWorkerは要求をSharedArrayBufferに書き込む。これは複数のWorkerが読み書きできる共有メモリだ。

書き込んだあと、Atomics.waitという命令でその場で止まる。カーネル役のWorkerがファイルの中身を書き戻すと、止まっていたWorkerが動き出し、関数が値を返す。本物のOSでシステムコールがプロセスを一時停止させるのと同じ形を、ブラウザのメモリ共有機能だけで再現している。

つまりNode.jsの各プロセスは、ブラウザの中にもう一つの小さなOSがあると信じ込んだまま、普段と同じコードを実行している。書き換えなしに動くという最初の主張は、この同期の仕組みに支えられている。ここまでで、本物と呼べる理由は分かった。残るのは、それでも一致しない部分がどこにあるかだ。

本物と一致しない部分はどこか

ここまでの説明だけだと、ブラウザで動くという制約がどこにも現れていないように見える。実際には、削られている機能がある。ただしその多くは、OpenVesselの手落ちではなく、ブラウザというプラットフォーム自体が持たない機能だ。

公式ドキュメントが挙げる主なものを整理する。

  • データベース接続やSSHのような、HTTP以外の生のTCP通信はできない。ブラウザのページがソケットを直接開けないため
  • UDP通信や生のDNS問い合わせもできない。ブラウザにUDPの機能がないため
  • node:http2はセッションの確立(ERR_NOT_IMPLEMENTED)ができない。これはブラウザの制約ではなく、OpenVessel側が未実装の部分
  • AsyncLocalStorageの追跡情報は、awaitをまたぐと消える。V8が外部に公開していない内部機能に頼っているため
  • CORSを許可しないサーバー(Google Fontsのメタデータなど)には届かない。すべての通信がブラウザのfetchを経由するため

対応ブラウザにも差がある。実行できるテスト数で比べると違いがはっきりする。

050010001516本Chrome: 1516Firefox: 148415161484ChromeFirefox

公式ドキュメントで、ChromeとFirefoxの違いを項目ごとに比べられる。

項目ChromeFirefox(現行リリース)
シェル・npm install動く動く
Astroのビルド・dev・HMR動く動く
Node.js公式テスト合格数1,516/1,516(100%)1,484/1,516(97.9%)
合格しなかった分の主因—V8とSpiderMonkeyでエラーメッセージ・スタックトレースの文字列が違う

表のとおり、Firefoxで合格しなかった32本の大半は、Node.jsの挙動そのものが原因ではない。機能が動かないのではなく、エラーの言い回しが一致しないという違いになる。

Astroサイトでの実績も、公式が実際の147サイトのコーパスで計測している。

構成ビルドできたサイト数
既定(Tailwind CSS 4.3.4)127 / 147
Tailwind CSS 4.3.3を指定131 / 147

残りは、CORSで止まる外部フォント取得や、Cloudflareのworkerdアダプタのようにブラウザで動かしようのない依存が原因だ。この記事が当てはまるのは、ネイティブ依存が少ない一般的なAstroサイトを、Chromium系ブラウザで動かす場合になる。

まとめ

OpenVesselは、Node.js自身のJavaScriptコードを書き換えない。C++部分だけをTypeScriptで作り直すことで、ブラウザのタブの中だけでnpm installからAstroのビルド・プレビューまでを完結させる。

fs.readFileSyncのような同期処理は、Web WorkerとSharedArrayBufferの組み合わせで動く。本物のOSのシステムコールと同じ形を、ブラウザの中で再現している。Node.js公式テストはChromeで対象の全数、Firefoxでも97.9%に合格した。削られているのはHTTP/2や生のTCP・UDPなど、ブラウザというプラットフォーム自体が持たない機能が中心だ。

GitHubリポジトリはApache License 2.0で公開されている。デモページを開けば、インストール無しでAstroサイトの編集とプレビューをその場で試せる。

この記事の先を読む本を探す

特定の本を勧めるものではありません。検索結果から、いまの版と目次を確かめて選んでください。

コメント

気づきや感想をどうぞ

記事への補足や、読んで考えたことをお寄せください。個人情報や、他の人を傷つける内容の投稿はお控えください。

コメントを読み込んでいます…

    ほかの記事

    最新の記事 →