🗻

Honoにvue-jsx-vaporを載せてみる

に公開1件

この記事はHono Advent Calendar 2025の17日目の記事です。

https://qiita.com/advent-calendar/2025/hono

HonoはWeb標準に準拠したシンプルなAPIを採用しているため、既存のJavaScriptフレームワークに組み込むのも簡単ですし、逆にHono上にフレームワークを載せるのもやりやすいです。

例えば、ReactのSSRをHonoに載せる試みは、この記事などで行われています。

https://zenn.dev/sora_kumo/articles/hono-ssr-react

Honoのメタフレームワークとして開発が進んでいるHonoXはBYOR(Bring Your Own Renderer)と呼ばれる機能を持っていて、レンダラを書くことができるJavaScriptフレームワークなら割と自由に載せ変えられるようになっています。

今回はこのHonoに vue-jsx-vapor を載せてみたのでその記録について紹介します。

Vue 3.6について

その前に現在アルファ版が公開されているVue 3.6の新機能について簡単に説明します。

https://github.com/vuejs/core/releases/tag/v3.6.0-alpha.1

Vue 3.6ではパフォーマンスに焦点が当てられ、核となる新機能が2つあります。

Vaporモード

Vapor(ベイパー)モードは仮想DOMを使用しない、新しいレンダリング方式です。

仮想DOMを使わず、直接DOMを操作するように作られているため、パフォーマンスの向上やバンドルサイズの削減による初期ロード時のオーバーヘッド減少が期待されています。

alien-signals

新しいリアクティビリティシステムです。 alien-signals というライブラリが基となっており、Solidのような Fine-Grained Reactivity が実現されました。


この2つの機能によって、Vue 3.6では ベンチマーク でSolidやSvelteに匹敵する速度を出しています。

詳しくは以下のスライドが参考になると思うので是非見てみてください。

https://speakerdeck.com/hiranuma/alien-signals-noshi-jian-topahuomansuzui-shi-hua

vue-jsx-vaporについて

vue-jsx-vapor はVue Vaporモード下でもJSXを利用できるようになるプラグインです。

https://github.com/vuejs/vue-jsx-vapor

まだ事例は多くない印象ですが、Vue自体はJSXにも対応しているんですよね。

https://ja.vuejs.org/guide/extras/render-function

僕はこれを見てHonoとの相性がなかなか良いんじゃないかと思いました。

  • 仮想DOMがない・Fine-Grained Reactivityを持つ
    • 仮想DOMを持つReactや hono/jsx/dom より早い(と思われる)
    • 軽量で早いHonoの良さを最大限活かすことができる
  • 特殊なJSX記法が少ない
    • v-for や v-if のようなディレクティブがありますが、比較的シンプルで分かりやすいと思います
    • もちろん、三項演算子や map 関数も使えます
  • Vueであるということ
    • Reactの次に大きなエコシステムを利用できます[1]

というわけで、実際に動かして試してみました。

やってみる

とりあえず動かしたいので、最低限として以下のようにしてみます。

  • SSR部分は hono/jsx をそのまま使う
  • 必要な部分をIslandとして vue-jsx-vapor をマウントする

今回はCloudflare Workersにデプロイする前提でビルドしてみますが、Honoはどこでも動くので静的アセットの扱い以外は基本変わらないはずです。

コードの全体像は以下のリポジトリになります。

https://github.com/hayatosc/hono-jsx-vapor

ディレクトリ構造

├── package.json
├── public
├── src
│   ├── client
│   │   ├── index.tsx
│   │   └── island
│   ├── index.tsx
│   ├── server
│   │   └── renderer.tsx
│   └── style.css
├── tsconfig.client.json
├── tsconfig.json
├── tsconfig.server.json
├── vite.config.ts
└── wrangler.jsonc

tsconfig

serverとclientで別々のjsxライブラリを使うことになるため、 tsconfig.client.json と tsconfig.server.json でそれぞれ分けています。

tsconfig.json
{
  "compilerOptions": {
    "target": "ESNext",
    "module": "ESNext",
    "moduleResolution": "Bundler",
    "strict": true,
    "skipLibCheck": true,
    "lib": ["ESNext", "DOM"],
    "esModuleInterop": true,
    "isolatedModules": true,
    "noEmit": true,
    "jsx": "react-jsx",
  },
}
tsconfig.server.json
{
  "extends": "./tsconfig.json",
  "compilerOptions": {
    "jsx": "react-jsx",
    "jsxImportSource": "hono/jsx",
    "types": ["vite/client", "@cloudflare/workers-types"],
  },
  "include": ["src/index.tsx", "src/server/renderer.tsx", "vite.config.ts"],
}
tsconfig.client.json
{
  "extends": "./tsconfig.json",
  "compilerOptions": {
    "jsx": "preserve",
    "jsxImportSource": "vue-jsx-vapor",
    "lib": ["ESNext", "DOM"],
  },
  "include": ["src/client/**/*.tsx", "src/client/**/*.ts"],
}

vite.config.ts

VueJsxVapor() は src/client 以下のみを対象とするように設定します。 esbuild.jsxImportSource は指定しないと上手く動作しませんでした。

vite.config.ts
import { cloudflare } from '@cloudflare/vite-plugin'
import { defineConfig } from 'vite'
import ssrPlugin from 'vite-ssr-components/plugin'
import VueJsxVapor from 'vue-jsx-vapor/vite'

export default defineConfig({
  esbuild: {
    jsx: 'automatic',
    jsxImportSource: 'hono/jsx',
  },
  plugins: [
    VueJsxVapor({
      macros: true,
      include: [/src\/client\/.*\.[tj]sx$/],
    }),
    cloudflare(),
    ssrPlugin(),
  ],
})

サーバーサイド

普通にHonoを書きます。

vite-ssr-components のおかげで開発モードの違いを気にすることなく書くことができて開発者体験が凄く良いです。

src/server/renderer.tsx
/** @jsxImportSource hono/jsx */
import { jsxRenderer } from 'hono/jsx-renderer'
import { Link, ViteClient, Script } from 'vite-ssr-components/hono'

export const renderer = jsxRenderer(({ children }) => {
  return (
    <html>
      <head>
        <meta charSet="utf-8" />
        <meta name="viewport" content="width=device-width,initial-scale=1" />
        <title>Hono + Vue JSX Vapor</title>
        <ViteClient />
        <Link href="/src/style.css" rel="stylesheet" />
        <Script type="module" src="/src/client/index.tsx" />
      </head>
      <body>{children}</body>
    </html>
  )
})
src/index.tsx
/** @jsxImportSource hono/jsx */
import { Hono } from 'hono'
import { renderer } from './server/renderer'

const app = new Hono()

app.use(renderer)

app.get('/', (c) => {
  return c.render(
    <main>
      <header>
        <h1>Hono + Vue JSX Vapor</h1>
        <nav>
          <a href="/benchmark">ベンチマーク →</a>
        </nav>
      </header>
      <section>
        <p>Vue JSX Vapor island</p>
        <div id="counter-island"></div>
      </section>
    </main>
  )
})

export default app

クライアントサイド

Vue Vaporコンポーネントを書きます。複雑なことはなく、 ref() と onClick で書けます。

src/client/island/Counter.tsx
import { ref } from 'vue'

export default function Counter() {
  const count = ref(0)
  return (
    <button
      type="button"
      onClick={() => (count.value += 1)}
    >
      count: {count.value}
    </button>
  )
}

これをマウントするには createVaporApp() を使います。これにより、読み込んだコンポーネント全体をVaporComponentとして認識させることができます。

src/client/index.tsx
import { createVaporApp } from 'vue'
import Counter from './island/Counter'

const el = document.getElementById('counter-island')
if (el) {
  createVaporApp(Counter).mount(el)
}

プレビューしてみるとこんな感じで、普通にレンダリングできていることが分かります。

ベンチマーク

せっかくなので hono/jsx/dom との比較のベンチマークをAIに作ってもらいました。簡単なリスト操作のベンチマークです。

https://github.com/hayatosc/hono-jsx-vapor/blob/main/src/client/benchmark/setup.ts

CPU 4x Slowdown環境下で、要素数1000、試行回数5回、状態更新回数20回の結果はざっくりこんな感じでした。

vue-jsx-vapor hono/jsx/dom
update 27.60 ms 55.50 ms
splice 27.30 ms 48.70 ms

ざっくり40~50%くらいの高速化…と言いたいところなんですが、よく考えたら自分はこのベンチマークの有効性を評価できないことに気づいてしまったので、これは参考値ということで。

気になる人はサイトにデプロイしてあるので自分で確かめてください。

https://hono-jsx-vapor.hayatosc.workers.dev/benchmark

SSR(したかった)

本当はSSRについての実装についても詳しくやりたかったんですが、 ReferenceError: document is not defined というサーバーエラーから抜け出せず泣く泣く断念しました…

ビルド設定とかimportの場所とか色々Claudeと一緒に試したんですが…結局変わらず…

Roadmap見る感じVaporモードのSSR対応自体はしてそうなんですが、もしかすると vue-jsx-vapor 側との組み合わせの問題かもしれません。

https://github.com/vuejs/core/issues/13687

ある程度Vaporエコシステムが安定したらNuxtが最初に実装を書いてくれるでしょうからそれ待ちですかね。

まとめ

僕はフロントエンドフレームワークはVueから入って、その後Reactに移行した際にJSX構文の有用性に気づいた身なので、最近のVueの発展は素直に嬉しく思います。

Honoも同じくらい大好きなので、この2つの良いフレームワーク同士が面白いマリアージュを起こしてくれないか、と大きな期待を寄せています。

将来的には vue-jsx-vapor をデフォルトにしたHonoのメタフレームワークを作れたら楽しそう。

脚注
  1. Vaporモードに対応しているのがComposition APIだけ(Options APIは非対応)なのと、既存のものが必ずしも動くとは限らない点は注意が必要ですが、 ecosystem-ci もあるしある程度動くようになるんじゃないかと期待してます。 ↩︎

Discussion

Yasumasa AshidaYasumasa Ashida

"The next step is to use the Virtual DOM to enable SSR for Vapor."

Vue.js 3.6.0-bata.1のVapor Mode では SSRをサポートしていますが、
vue-jsx-vapor の3.1.0(2025/12/25現在の最新バージョン)では、(Vapor Modeの)SSRをまだサポートしていません。(なので、DOMを利用しようとして、「document is ...」のエラーとなっているようです。)

https://x.com/zhiyuanzmj/status/2004109574841029117?s=46&t=7JFR8PbhUv-Zbrp0VDzyuQ