# ライブラリとの比較

Web アプリが普段は人気の JavaScript ライブラリに任せる処理を、Go で書いて goesm でコンパイルすると、サイズと速度はどうなるか。ここではそれを比べる。各比較は同じ処理を 2 回実装する。1 つは goesm でコンパイルする Go パッケージで、もう 1 つはそのライブラリを使う JavaScript である。両者は同じ方法でバンドルし、同じ処理を JavaScript から呼んで計測する。JavaScript 側は処理が呼ぶものだけを import する。これと同じく、Go 側のバンドルは処理が呼ぶ関数だけを export する。このため、アプリの場合と同じく、バンドラーは残りを削除できる。両者の結果が一致しない場合、計測は失敗する。

| ライブラリ | Go パッケージ | 両者が行う処理 |
| --- | --- | --- |
| [luxon](https://moment.github.io/luxon/) 3.7.2 | [`datetime`](https://github.com/goesm-dev/goesm/blob/v0.0.1-beta.9/compare/datetime/datetime.go)、`time` を使う | オフセット付きの RFC 3339 の日時を解析し、暦日で加算し、2 つの日時の間の日数を数え、表示用に整形し、カレンダー 1 か月分の 42 日を並べる |
| [neverthrow](https://github.com/supermacro/neverthrow) 8.2.0 | [`result`](https://github.com/goesm-dev/goesm/blob/v0.0.1-beta.9/compare/result/result.go)、`errors`・`fmt`・`strconv` を使う | 注文 500 行を検証する。各段階は文脈を付けてラップしたエラーを返す。有効な行の合計を出す |
| [connect-es](https://connectrpc.com/docs/web/) 2.2.0 | [`rpc`](https://github.com/goesm-dev/goesm/blob/v0.0.1-beta.9/compare/rpc/rpc.go)、connect-go と protobuf-go を使う | Connect サービスの unary 呼び出しを、protobuf のバイナリ形式で `fetch` 経由で 50 回行う |
| [React](https://react.dev/) 19.3.0 | [`render`](https://github.com/goesm-dev/goesm/blob/v0.0.1-beta.9/compare/render/render.go)、`html/template` を使う | 商品 100 件のページを HTML にレンダリングする。React は `renderToString`、Go はテンプレートを使う |
| [VitePress](https://vitepress.dev/) | [`markdown`](https://github.com/goesm-dev/goesm/blob/v0.0.1-beta.9/compare/markdown/markdown.go)、[goldmark](https://github.com/yuin/goldmark) を使う | CommonMark の文書を HTML にする。JS 側は VitePress が使う markdown-it 15.0.2 |
| [Astro](https://astro.build/) | 同じ `markdown` | 同じ文書を、Astro が使う remark と rehype（unified 11）で HTML にする。Astro は Markdown を Node.js 上で処理するため、Node.js 向けにビルドする |
| [Vue](https://vuejs.org/) | [`reactive`](https://github.com/goesm-dev/goesm/blob/v0.0.1-beta.9/compare/reactive/reactive.go)、ref・computed・effect を Go で実装したもの | 20 段の computed の連鎖 50 本、ダイヤモンド型の依存、それらを読む effect を作り、ref を 2,000 回変更する。JS 側は @vue/reactivity 3.5.43 |
| [Tailwind CSS](https://tailwindcss.com/) 4.3.3 | [`utility`](https://github.com/goesm-dev/goesm/blob/v0.0.1-beta.9/compare/utility/utility.go)、ユーティリティファーストの CSS を生成する Go の実装 | ランディングページ [js/page.html](https://github.com/goesm-dev/goesm/blob/v0.0.1-beta.9/compare/js/page.html) の 154 個のクラス名に対するスタイルシートを、Tailwind の既定のテーマから作る。Go 側の CSS は Tailwind の出力とバイト単位で一致しなければならない |

フレームワークについては、ページが最も依存する部分を比べる。React はレンダリング、VitePress と Astro は Markdown のレンダラー、Vue はリアクティビティ、Tailwind はページのクラス名を CSS にするコンパイラを対象にする。Go 側は、ネイティブのプログラム向けに書くのと同じ普通の Go のコードである。`%w` 付きの `fmt.Errorf`、`time.Parse`、生成された protobuf の型、`html/template` を使う。Go には比べられるリアクティビティの仕組みがないため、`reactive` はこの比較のために Vue 3.5 と同じアルゴリズムで書いたものである。計算が読む ref や computed の一覧と、ref や computed を購読する計算の一覧は、同じリンクをつないだ双方向リストであり、リンクは版数を持つ。このため、前回と同じものを読んだ計算はリンクを再利用し、読んだものが変わっていない computed は再計算しない。`utility` も同様にこの比較のために書いたものである。テーマの CSS を読み、Tailwind と同じ方法でユーティリティを組み立てる。Tailwind の静的なユーティリティ、静的なバリアント、プロパティの並び順は、[js/gen-utility.mjs](https://github.com/goesm-dev/goesm/blob/v0.0.1-beta.9/compare/js/gen-utility.mjs) が tailwindcss のパッケージから生成する表から読む。対象は一般的なページが使うユーティリティと、値を取らないバリアントである。`group-*`、`peer-*`、`not-*`、`max-*` などの複合的なバリアントや値を取るバリアントは扱わない。JavaScript 側はライブラリの通常の API を使う。Markdown のレンダラーはいくつかの文字のエスケープの仕方が異なるため、そのエスケープを戻してから HTML を比べる。入力と処理は [js/libs.mjs](https://github.com/goesm-dev/goesm/blob/v0.0.1-beta.9/compare/js/libs.mjs) に、JavaScript 版は [js/impl/](https://github.com/goesm-dev/goesm/tree/v0.0.1-beta.9/compare/js/impl) にある。

3 つの比較には、[light/](https://github.com/goesm-dev/goesm/tree/v0.0.1-beta.9/compare/light) に 2 つ目の Go パッケージがあり、表では「(light)」と示す。同じ処理を、バンドルを意識して書いたものであり、1 つ目のパッケージを大きくしている標準ライブラリのパッケージを使わない。[`light/result`](https://github.com/goesm-dev/goesm/blob/v0.0.1-beta.9/compare/light/result/result.go) は、任意の値を `reflect` で整形する `fmt.Errorf` を使わず、独自のエラー型でメッセージを組み立てる。[`light/rpc`](https://github.com/goesm-dev/goesm/blob/v0.0.1-beta.9/compare/light/rpc/rpc.go) は、connect-go、protobuf のランタイム、`net/http` を使わず、2 つのメッセージを手書きでエンコードとデコードし、`syscall/js` 経由で `fetch` を呼ぶ。[`light/render`](https://github.com/goesm-dev/goesm/blob/v0.0.1-beta.9/compare/light/render/render.go) は、`html/template` でテンプレートを解釈せず、templ が生成するコードと同じようにコンポーネントごとの関数で `strings.Builder` にページを書き、`html.EscapeString` でエスケープする。これらの結果も、ライブラリの結果と一致しなければならない。

## 結果

| 比較対象 | Go パッケージ | goesm gzip | JS gzip | 比 |
| --- | --- | --- | --- | --- |
| luxon | `datetime` | 21.2 KiB | 21.7 KiB | 0.98× |
| neverthrow | `result` | 48.5 KiB | 2.4 KiB | 20.30× |
| neverthrow (light) | `light/result` | 19.4 KiB | 2.4 KiB | 8.11× |
| connect-es | `rpc` | 1226.0 KiB | 32.9 KiB | 37.31× |
| connect-es (light) | `light/rpc` | 14.8 KiB | 32.9 KiB | 0.45× |
| react | `render` | 315.7 KiB | 64.3 KiB | 4.91× |
| react (light) | `light/render` | 15.9 KiB | 64.3 KiB | 0.25× |
| vitepress | `markdown` | 163.6 KiB | 40.4 KiB | 4.05× |
| astro | `markdown` | 163.6 KiB | 47.2 KiB | 3.46× |
| vue | `reactive` | 6.8 KiB | 5.3 KiB | 1.29× |
| tailwind | `utility` | 64.9 KiB | 72.2 KiB | 0.90× |

| 比較対象 | node 26.10.0 goesm | node 26.10.0 JS | 比 | bun 1.4.2 goesm | bun 1.4.2 JS | 比 |
| --- | --- | --- | --- | --- | --- | --- |
| luxon | 1.9 ms | 8.3 ms | 0.23× | 4.0 ms | 7.1 ms | 0.57× |
| neverthrow | 0.47 ms | 0.50 ms | 0.94× | 0.56 ms | 0.55 ms | 1.02× |
| neverthrow (light) | 0.41 ms | 0.46 ms | 0.89× | 0.55 ms | 0.47 ms | 1.17× |
| connect-es | 16 ms | 2.3 ms | 7.09× | 20 ms | 1.9 ms | 10.29× |
| connect-es (light) | 1.6 ms | 2.3 ms | 0.70× | 1.2 ms | 2.0 ms | 0.59× |
| react | 2.7 ms | 1.6 ms | 1.67× | 3.6 ms | 1.9 ms | 1.89× |
| react (light) | 0.17 ms | 1.6 ms | 0.11× | 0.19 ms | 1.8 ms | 0.11× |
| vitepress | 0.35 ms | 0.21 ms | 1.71× | 0.51 ms | 0.14 ms | 3.63× |
| astro | 0.31 ms | 2.0 ms | 0.15× | 0.39 ms | 2.5 ms | 0.16× |
| vue | 5.4 ms | 5.6 ms | 0.97× | 5.7 ms | 5.3 ms | 1.07× |
| tailwind | 2.3 ms | 4.0 ms | 0.56× | 2.8 ms | 3.2 ms | 0.88× |

サイズは minify した ES モジュールのバンドルを gzip のレベル 9 で圧縮したものである。時間は、ウォームアップ後に処理を 1 回実行した時間の中央値である。connect-es の処理では、エンコード済みの応答を返す `fetch` を同じプロセス内に置く。このため、計測するのはクライアントの処理だけ、すなわちリクエストのエンコード、プロトコルの処理、応答のデコードである。

## 実行方法

```sh
cd compare/js
npm ci
node build.mjs                      # このチェックアウトの goesm をビルドし、各比較の両者を ../out にビルドする
node run.mjs > ../results/node.jsonl
bun run.mjs > ../results/bun.jsonl
node report.mjs ../results/node.jsonl ../results/bun.jsonl   # 上の表を更新する
```

`GOESM=/path/to/goesm node build.mjs` とすると別の goesm のバイナリを使う。`node build.mjs luxon` や `node run.mjs -quick luxon` のように指定すると、一部の比較だけを実行する。計測は、マシンでほかに重い処理が動いていないときに行う。Bun のガベージコレクションの動作が変わるため、`BUN_OPTIONS=--smol` は指定しない。バンドルは esbuild で minify し、ブラウザ向けの ES モジュールとして作る。Go 側にあるわずかな `node:` の import は外部参照のまま残す。

[proto/](https://github.com/goesm-dev/goesm/tree/v0.0.1-beta.9/compare/proto) の Go と TypeScript のコードは `buf generate` で生成する。使うプラグインは [buf.gen.yaml](https://github.com/goesm-dev/goesm/blob/v0.0.1-beta.9/compare/buf.gen.yaml) にある。
