Upgrade to Pro — share decks privately, control downloads, hide ads and more …

The Cost of the DOM

ypresto
November 22, 2026

The Cost of the DOM

jsdom / happy-dom と Vitest Browser Mode の実行時間を分解する

JSConf JP 2026

ypresto

November 22, 2026

Transcript

42 slides
  1. The Cost of the DOM jsdom / happy-dom と Vitest

    Browser Mode の実行時間を分解する ypresto ・ JSConf JP 2026 ・ トラック C ・ 13:00 © LayerX Inc.
  2. ypresto (プレスト) @ypresto @yuya_presto • LayerX バクラク事業部(2024-01〜) • Software Engineer

    + Frontend Enabling • フロントエンドのリアーキテクチャ・基盤整備
  3. UI テスト基盤 Storybook Vitest Addon を全プロダクトに展開 普通のStorybook:Storybook サーバを起動してテスト実行 Vitest Addon:コマンド一発実行なので

    Agent にやさしい、Agent の「目」 コマンド一発でスクショ取るツールも作った https://github.com/ypresto/storycap-run
  4. UI テスト基盤 DOM をエミュレートするか、実ブラウザを使うか DOM エミュレーション(Node の中) 実ブラウザ Jest /

    Vitest Vitest Browser Mode Chromium test を管理・module を変換 Node の process 本物の DOM・CSS・layout ▼ 起動 Playwright ▶ ブラウザを操作 CDP 起動・入力 Node.js worker(子 process / thread) vm context(test file ごとに 1 つ) Vite HTTP module を配る テストコード ▲ ▼ テストの実行管理 DOM を操作 jsdom / happy-dom JS で作った DOM 開始の指示・結果の受け取り テストコード ▶ module を変換 ◀ Storybook Vitest Addon 任意:story を組み立てて play を流す (test への変換は Node 側の ▶ WebSocket 開始指示・結果返却 ブラウザ操作の依頼 iframe(test file ごとに 1 つ) Vite plugin)
  5. 課題 2 か月半で CI がマシンを使う量が約 2.6 倍になった 約 2.6 倍

    約3割 4.9 → 7.5 分 CI 全体の core・分(推定) そのうち UI の test 2026 年 9 月初め 1 日 約 25.6 万 vitest を動かす job が全体の 24%。 Storybook と Vitest unit の job 1 回 core・分 → 11 月中旬 約 67.7 万。 Storybook の test だけで 7.4%(1 ある webapp の Storybook と unit run 数も 1 日 1.5 万 → 2.5 万 日 約 5 万 core・分) の test の job 平均、2026 年 7 月 → 10 月。主因は test の数の増加 (unit の test file 174 → 476、 story 1,121 → 1,478) test の時間は 2 つの合計で 2.9 → 4.3 分(Storybook の test 2.3 → 3.1、Vitest の unit 0.6 → 1.2) 計算量はどちらも推定。11 月(11/9〜11/13):run 12.4 万件のうち約 8,500 件を無作為に抜き出して job の時間を測り、workflow ごとの run 数を掛け た(95% 区間 64〜72 万)。9 月(9/2〜9/3):別の監査の 36 時間分を 1 日に換算。core 数は runner の種類から決めた確保量で、実際に使った CPU では
  6. 増え続ける test test の量は増え続ける。どれが正解か、今確かめておきたい バクラクの monorepo ・ Vitest で動く test(月初め、2025

    年 1 月 → 2026 年 11 月) Vitest の unit / component test: file 数 ▪ DOM 依存(hooks 含む) ▪ Storybook Vitest Addon の story ▪ DOM 環境だが DOM 不使用 test の数(it( / test( と story、概数) 18 か月で file は約 98 倍、test は約 10 万件。しかも加速している(月の伸び率 +30% → +40%)。 ▪ Node 環境
  7. DOM エミュレーション ・ コード 1/2 window も DOM 操作も、素の JS

    の object と配列で再現 1. window を作る(Vitest の env) happy-dom.ts const { Window } = await import('happy-dom') let win = new Window({ url: 'http://localhost:3000' }) return { getVmContext() { return win } } // vmThreads では、この window がそのまま test の global 2. appendChild と querySelector Node.ts・QuerySelector.ts node[parentNode] = self this[nodeArray].push(node) // ただの配列に push node[connectedToNode]() // observer に通知 // querySelector:結果を cache、なければ木を順に照合 for (child of children) selectorItem.match(scope, child) happy-dom 21.0.4 / Vitest 5.1.1 から抜粋・簡略化(PropertySymbol の key や validation は省略、TODO は原文のまま)
  8. DOM エミュレーション ・ コード 2/2 event は for 文で listener

    を呼ぶだけ、幅や高さは 0 3. dispatchEvent EventTarget.ts const path = event.composedPath() for (let i = path.length - 1; i >= 0; i--) path[i].dispatchEvent(event) // capture → bubble // 各 node では listener を for 文で順に呼ぶだけ 4. getBoundingClientRect Element.ts public getBoundingClientRect(): DOMRect { // TODO: Not full implementation return new DOMRect() // x・y・幅・高さ すべて 0 } happy-dom 21.0.4 / Vitest 5.1.1 から抜粋・簡略化(PropertySymbol の key や validation は省略、TODO は原文のまま)
  9. DOM エミュレーション ・ Web API の対応状況 レイアウトやネイティブの機能は stub API jsdom

    26.1 happy-dom 21.0.4 navigator.clipboard なし JS の配列に保存する matchMedia なし(test 側で mock) window.innerWidth の値(既定 1024)で式を評 価 ResizeObserver / IntersectionObserver なし observe() が // TODO elementFromPoint / scrollIntoView なし elementFromPoint は null、scrollIntoView は何 もしない click が本当に押せるか (見えている・覆われていない・止まって いる) 確かめない(layout がない) 確かめない(layout がない) PointerEvent / getAnimations なし あり React Aria のテストは jsdom の「なし」 に依存していて、happy-dom に差し替えると PointerEvent 関係で 13 fail
  10. Vitest のパフォーマンス Vitest の並列実行方法 DOM エミュレーション(Node の中) 実ブラウザ Jest /

    Vitest Vitest Browser Mode Chromium test を管理・module を変換 Node の process 本物の DOM・CSS・layout ▼ 起動 Playwright ▶ ブラウザを操作 CDP 起動・入力 Node.js worker(子 process / thread) vm context(test file ごとに 1 つ) Vite HTTP module を配る テストコード ▲ ▼ テストの実行管理 DOM を操作 jsdom / happy-dom JS で作った DOM 開始の指示・結果の受け取り テストコード ▶ module を変換 ◀ iframe(test file ごとに 1 つ) Storybook Vitest Addon 任意:play がテストコードに ▶ WebSocket 開始指示・結果返却 ブラウザ操作の依頼 iframe の方は isolate で切り替える (false なら iframe を使い回す) pool(forks / vmThreads など)と isolate で、file ごとの分け方を切り替える ※ 並列数を maxWorkers で設定可能
  11. Vitest Browser Mode の worker test file は Vite が変換して

    HTTP で配り、本物の Chromium が読み込んで動かす worker数 = iframeの数 Vite が要るのは、browser が TS・JSX・bare import をそのまま読めないから。
  12. Vitest の仕組み ・ pool と isolate file ごとに作り直す 隔離のレベルが速度に影響する isolate:

    true (default) pool: vmThreads (vmForks) file ごとに worker(process)を作り直す worker を使い回し、file ごとに vm context (global scope) を作成 Jest もほぼこれ(1.30 秒) worker(process) test file 1 起動して import し直す worker(process) test file 2 起動して import し直す worker(process 1 個) 読み込んだ module の多くを 再利用 vm context test file 1 vm context test file 2 … 32 file 分 … 32 file 分 8.94 秒 1.20 秒 process 32 個 process 1 個 中身が空の test を 32 file、1 worker、各 1 回の実時間(Vitest 5.1.1)。効いているのは process の起動と import のやり直し。 使い回す
  13. Vitest の仕組み ・ pool と isolate file ごとに作り直す 使い回す 隔離のレベルが速度に影響する

    isolate: true (default) pool: vmThreads (vmForks) Browser Mode isolate: true (default) Browser Mode isolate: false file ごとに worker(process)を作り直す worker を使い回し、file ごとに vm context (global scope) を作成 Jest もほぼこれ(1.30 秒) browser を使い回し、file ごとに iframe を作り直す iframe も module も 使い回す browser(1 個) browser(1 個) worker(process) test file 1 起動して import し直す worker(process) test file 2 起動して import し直す worker(process 1 個) 読み込んだ module の多くを 再利用 vm context iframe test file 1 iframe(1 個)・module も 共有 iframe test file 2 test file 1 test file 1 test file 2 … 32 file 分 … 32 file 分 … 32 file 分 vm context test file 2 注意:module を共有するので、 vi.mock() は最初に読んだ版 (本物か mock)で固定されて壊 れる。 … 32 file 分 8.94 秒 1.20 秒 process 32 個 process 1 個 2.02 秒 1.38 秒 中身が空の test を 32 file、1 worker、各 1 回の実時間(Vitest 5.1.1)。効いているのは process の起動と import のやり直し。
  14. Vitest の仕組み ・ pool とisolate isolateをオフにすると、お行儀の悪いテストが火を吹く 同じ worker で A

    → B の順 // file A:test 用に差し替え HTMLElement.prototype.scrollIntoView = () => {} // file B:同じ worker の次の file HTMLElement.prototype.scrollIntoView // happy-dom の vmThreads では A のまま 環境 global トップレベル 定義の汚染 spy vi.mock jsdom + vmThreads clean clean clean clean happy-dom + vmThreads clean 残る clean clean Browser Mode isolate=false (何も戻さない) 残る 残る 残る 最初の版で 固定 isolate=true(どの環境 でも) clean clean clean clean happy-dom の DOM の class(HTMLElement など)は worker に 1 組だけ。vm context を作り直しても共有される。 jsdom は window ごとに作り直すので残らない。
  15. 題材 有名な component library の大量の test で確かめる 10,191 tests 3,391

    tests codemod + .patch @mantine/core 9.8.0 実際に直したもの components の test 全件 React Spectrum の 4 package 218 files react-aria 実ブラウザの本物の layout や挙動 もとは Jest + jsdom react-aria-components に合わせて手直し @react-spectrum/s2 @react-spectrum/ai 188 files もとは Jest + jsdom 環境 MacBook Pro(M4 Pro・14 core)・4 worker AST 変換に加えて
  16. 結果 ・ 2 つの題材 実時間は jsdom の 1.2〜2.3 倍 実時間

    ・ 4 worker ・ run 全体 Mantine 218 file・10,191 test happy-dom Browser Mode 5.1.1 React Aria 188 file・3,391 test 14.5 秒 20.2 秒 20.5 秒 23.7 秒 Browser Mode 5.1.0 jsdom Jest + jsdom 50.5 秒 17.2 秒 20.0 秒 5.1.1 は jsdom より 3.3 秒遅い。5.1.0 より 3.2 秒(13%) 速い 21.9 秒 24.0 秒 jsdom の 2.3 倍。失敗は Browser 25 件、ほかは 0 件
  17. 結果 ・ 2 つの題材 実時間は jsdom の 1.2〜2.3 倍 実時間

    ・ 4 worker ・ run 全体 Mantine 218 file・10,191 test happy-dom Browser Mode 5.1.1 React Aria 188 file・3,391 test 14.5 秒 20.2 秒 20.5 秒 23.7 秒 Browser Mode 5.1.0 jsdom Jest + jsdom 50.5 秒 17.2 秒 20.0 秒 5.1.1 は jsdom より 3.3 秒遅い。5.1.0 より 3.2 秒(13%) 速い 52.7 秒* 21.9 秒 24.0 秒 jsdom の 2.3 倍。失敗は Browser 25 件、ほかは 0 件
  18. 結果 ・ 2 つの題材 CPU time で見ると差は縮む:実時間の差の大半は wait CPU 時間・

    4 worker ・ run 全体 Mantine 218 file・10,191 test happy-dom 59.6 秒 Browser Mode 5.1.1 63.1 秒 Browser Mode 5.1.0 jsdom Jest + jsdom React Aria 188 file・3,391 test 100.3 秒 121.8 秒 79.9 秒 70.5 秒 76.7 秒 5.1.1 は jsdom より 7.4 秒(10%)少ない。5.1.0 より 16.8 秒(21%)少ない 148.3 秒* 106.4 秒 115.8 秒 jsdom の 1.14 倍(実時間は 2.3 倍)
  19. 中身の比較 起動から終了まで並べても、DOM・描画は小さい 経過時間 ・ 1 worker ・ Mantine 218 file

    ・ Vitest 5.1.0 happy-dom vmForks・isolate=false Browser Mode Chromium・isolate=true 16.1 38.6 14.5 37.7 12.2 6.5 7.0 12.6 DOM・描画 2.0 起動・終了(1 回だけ) ブラウザの待ち file ごとの iframe の準備 DOM・描画 test の前(読み込み・setup) 74.8 秒 9.1 39.1 124.5 秒 待ち以外 85.4 秒 test と hook(JS・React) その他の renderer の仕事 test の後 ネイティブ DOM は速いがそもそも割合が低い。 Browser Mode の上乗せは、iframe の準備(9.1 秒)とブラウザの待ち(39.1 秒)。
  20. 結果 ・ 入力の違い 同じ userEvent.click() でも、通る道が違う jsdom / happy-dom(@testinglibrary/user-event) Browser

    Mode(vitest/browser → Playwright) // ① iframe → WebSocket → Vitest に依頼 // ② Vitest → Playwright の locator.click() // ① 同じ JS の中で event を作る // ③ 確かめる:見えている・2 フレーム止まっている // ② dispatchEvent で配る // pointerdown → mousedown → focus // → mouseup → click // ・有効・その座標で一番上にいる // ④ CDP で OS の入力と同じ経路で押す // ⑤ hit test・event・既定動作はブラウザが本物で // ③ focus などの既定動作も JS で再現 // ⑥ 逆の経路で返事 → test が次へ // ④ macrotask を 1 つ待つだけ click 約 50 ms ほぼ 0 ms jsdom の user-event Browser Mode の userEvent event の isTrusted false(script が作る) true(OS の入力と同じ扱い) 当たる要素 指定した要素に直接 画面の座標で一番上の要素 押せるかの確認 pointer-events と disabled くらい 見えている・止まっている・覆われていない・サイズがある
  21. 結果 ・ click 1 回のシーケンス 内訳は推定 click 1 回は約 3

    フレーム(確かめて 2、待って 1) click 全体の約 50 ms は Mantine での実測。② と ⑤ の内訳は推定(Playwright の実装とキー入力の trace から)。
  22. 分解 5 ・ 並列化 待ちは並列数で減らせる 実時間 1 worker 4 worker

    100.5 → 90.9 秒 23.8 → 21.8 秒 フレーム上限なし。待ちがそのまま実時間に出る 同じ変更で −2.0 秒だけ。待ちは他の worker の仕事で埋 まる 待ちはどこから? DOM エミュレーションにはない待ち フレーム:Playwright は操作の前に、要素の位置が次のフレームでも同じか確かめる(vsync を待つ) process の間の往復:Node の test runner ↔ browser(WebSocket の RPC)、Playwright ↔ Chromium(CDP) module の取得:iframe ごとに HTTP で Vite server から読み込む jsdom / happy-dom は test と同じ process の中で、ほぼ同期的に動く 並列にすると、待ちは隠れ、CPU の取り合いが表に出る。
  23. Storybook ・ 中で何が起きているか addon は story file の末尾に test を足し、ブラウザで

    story を組み立てて play を流す ① Node 側:story file を test file に変換する(Vite plugin) // 自分で書いた story(そのまま残る) export default { component: Button }; export const Primary = { play: async ({ canvas }) => { … }, }; // ↓ plugin が末尾に足す(概念) test('Primary', testStory('Primary', Primary, meta, …)); ② ブラウザ側:story を組み立てて流す(iframe の中) setup:.storybook/preview の annotations(decorator・ parameters・loaders)を読み込む composeStory:story と preview の annotations を重ねる (portable stories と同じ仕組み) runStory:loaders → 描画(renderToCanvas)→ play instrumenter:play の中の expect・userEvent・query を 1 つずつ包んで記録。Storybook の画面(Interactions パネル) に表示するためだけで、Vitest では使われない test の中で重いのは runStory 1.5 秒、test-utils 0.8 秒、 story file を babel で解析し(loadCsf)、recast で書き戻す。tags で test にす renderToCanvas 0.4 秒(1 worker の profile) る story を絞る。Node 側で約 2.4 秒(1 worker、毎回解析) 同じ play を Browser Mode だけで流す版との差は、① の変換と、② の組み立て・instrumenter・iframe ごとの Storybook の bundle の評価。関数の名前 と変換の形は、今回使った Storybook の版のもの。
  24. Storybook ・ どこに時間がかかるか 描画そのものは小さく、記録・読み込み・組み立てが積み上 がる 場所 何をしているか 時間 測り方 ①

    Node story file を test に変換(babel で解析・recast で書き戻す) 約 2.4 秒 1 worker の CPU profile ① Node 起動時に全 story の索引づくり 約 1.7 秒 1 file だけ流した時の差の内訳 ② ブラウザ file ごとの setup・preview の読み込み +3.2 秒 4 worker の実時間の差 ② ブラウザ instrumenter + 小さな機能 5 つ +3.3 秒 4 worker の実時間の差 ② ブラウザ runStory(loaders → 描画 → play) 1.5 秒 1 worker の CPU profile ② ブラウザ うち renderToCanvas(描画) 0.4 秒 1 worker の CPU profile ② ブラウザ test-utils(composeStory など) 0.8 秒 1 worker の CPU profile Mantine 218 file。「+」は同じ play を Storybook なしで流した時との差(4 worker の実時間、Vitest 5.1.1、11/22 の回)。ほかは 11/17 の 1 worker の CPU profile で、測り方が違うので足し合わせない。
  25. Storybook ・ 最適化 修正案を全部入れると、上乗せは半分以下 実時間 ・ 4 worker ・ run

    全体(Mantine、Vitest 5.1.1) Storybook そのまま 29.0 秒 Storybook + 今日できる設定 27.8 秒 Storybook + 修正案まで全部 19.3 秒 Storybook なし(同じ play) 14.7 秒 Storybook なしとの差:そのまま +14.3 秒 → 今日できる設定 +13.1 秒 → 修正案まで全部 +6.6 秒(CPU は +62 → +24 秒) 交互に各 3 回のパイロット値(バッテリー 15% 以上・AC・idle 待ち)。「修正案と同じ 2 つの変更」は、修正案の行に入っている React の開発用 API の 削除とフレーム上限なしを、Storybook なしの側にも入れたもの(Storybook の上乗せだけを比べるため)。修正案は手元の改造で、まだ upstream には ない。
  26. Storybook ・ 上乗せのまとめ(Vitest 5.1.1) Storybook の上乗せ:+14 秒・CPU +59 秒 上乗せの中身

    実時間 秒 CPU 秒 改善方法 play を記録する instrumenter + 小さな機能 5 つ (features・viewport・pauseAnimations・preview の HTML・mocker) 3.3 17.7 Vitest で流すときは instrumenter を素通しに (patch) / features と viewport は設定でオフにする。 起動の固定費(全 story の索引づくり・CSF の解析) 3.5 4.8 起動時の索引づくりを省く(Vitest で流すときは要らない) (patch) file ごとの読み込み(Storybook の setup・preview の 評価) 3.2 10.7 - 1 test ごとの残り(composeStory・runStory・act の 待ち) 4.4 25.7 - 合計(Storybook 30.8 秒 − 同じ play を Storybook な しで 16.4 秒) 14.4 59.0 改善を適用できると、差は 14.3 → 6.6 秒、CPU 差は 62 → 24 秒
  27. まとめ Browser Mode と DOM エミュレーション 使い分けるべき? 正確さは、本物のブラウザが上。移行は AST 変換でほぼ済む。残るのは速さだけ。

    Mantine 実時間 ・ 4 worker jsdom happy-dom React Aria 実時間 ・ 4 worker Browser Mode 5.1.1 jsdom happy-dom Browser Mode 5.1.1 17.2 秒 14.5 秒 20.5 秒 21.9 秒 20.2 秒 50.5 秒 CPU:jsdom 70.5 ・ happy-dom 59.6 ・ Browser Mode 63.1 秒 CPU:jsdom 106.4 ・ happy-dom 100.3 ・ Browser Mode 121.8 秒 Browser Mode 1 本でやっていけ...る...?
  28. 結果 ・ キー入力 1 回のシーケンス trace で確認 入力のあと、ブラウザは次の描画まで返事を受け取らない test のコードも同じ

    renderer の main thread で動いて Vitest に指示を出しているので、このメッセージを受け取るまで次の行へ進めない。
  29. リベンジ ・ React Aria 1 フレームの待ちを外すと、React Aria は 24% 速くなる

    実時間 ・ 4 worker ・ 3,391 test ・ 同じ回に交互に各 3 回 Browser Mode 既定 Chromium そのまま 51.4 秒 Browser Mode + flag 1 つ 入力のあとも返事を受け取る 39.0 秒 jsdom(参考) 別の回の値 21.9 秒 実時間 file の時間の合計 正しさ −12.4 秒 −48.9 秒 新しい失敗 0 51.4 → 39.0 秒(−24%) 176.5 → 127.6 秒。CPU はほぼ同じ むしろ 4 件が通るようになった (126.8 → 121.2 秒) (ComboBox・Sheet など) flag:--enable-features=DeferRendererTasksAfterInput:policy/minimal-types(入力のあと止める task から network を外す)。jsdom は別の回の値で、 引き算はしない。Chromium の実験用の設定で、本物の Chrome の動きとは変わる。
  30. まとめ Browser Mode と DOM エミュレーション 使い分けるべき? 正確さは、本物のブラウザが上。移行は AST 変換でほぼ済む。残るのは速さだけ。

    Mantine 実時間 ・ 4 worker jsdom happy-dom React Aria 実時間 ・ 4 worker Browser Mode 5.1.1 jsdom happy-dom Browser Mode(ポテンシャル) 17.2 秒 14.5 秒 20.5 秒 21.9 秒 20.2 秒 39.0 秒 CPU:jsdom 70.5 ・ happy-dom 59.6 ・ Browser Mode 63.1 秒 CPU:jsdom 106.4 ・ happy-dom 100.3 ・ Browser Mode 121.2 秒 ポテンシャル=入力のあとの 1 フレーム待ちを外した値(同じ回の既定 51.4 秒・CPU 126.8 秒) Browser Mode 1 本でやっていけそう!!

More Decks by ypresto

Other Decks in Programming