【前編】このAPIいつ使うん？あの機能なに？V8のドキュメント、全部読んでみた

https://kyotojs.connpass.com/event/402321/ での発表資料です。後半はいずれ披露します。

本当に全部読んでいるかどうかは、V8 Docs をまとめた Google Docs をご覧ください。

Transcript

1. 【前編】このAPIいつ使うん？ あの機能なに？ V8のドキュメント、全部読んでみた 2026/09/03 did0es
2. Hirai Shuta | did0es（🗣 ディドス） SWE / Next Experts (Client, TypeScript) @サイバーエージェント FEC Association 代表理事 / FEC Tokyo 実⾏委員⻑ More: https://did0.es
3. この度、東京陣営に寝返りました！ 実は6年前にKyoto.jsで喋ってました
4. 去年関⻄で遭遇した、衝撃の登壇のパロディです https://x.com/0e2b3c/status/1995008624620703888
5. 独⾃の進化を遂げた ガラパゴスだと思ってください🏝🦜
6. みんなの率直な気持ち ① LLMで要約すれば良くない？ ② 本当に読んできたの？
7. みんなの率直な気持ち ① LLMで要約すれば良くない？ ② 本当に読んできたの？
8. ① LLMで要約すれば良くない？ のアンサー みんなのAIエージェントの トークンを節約しに来ました♡
9. おれはV8ドキュメントエージェント
10. みんなの率直な気持ち ① LLMで要約すれば良くない？ ② 本当に全部読んできたの？
11. ② 本当に全部読んできたの？ のアンサー 😭
13. 多い
14. 前半のV8のAPIにフォーカスする 許して
15. ※冒頭の⽬次の⼀部※
16. APIどこ
17. つべこべ⾔わず全部読む お前の始めた物語だろ！
18. ⾃分で頑張って読んでます。本当です!信じてください! ココに 注目⤵
19. Embedding V8付近でAPI出現
20. API関連の記述を発⾒して安⼼ 安⼼してください、叩けますよ
21. 【前編】このAPIいつ使うん？ あの機能なに？ V8のドキュメント、読んでみた 2026/09/03 did0es
22. Docsで⾯⽩いと思った部分を かいつまんで紹介します
23. 今⽇お話すること ① まずは、V8をビルドする ② 開発の準備とデバッグ ③ APIに触れる ④ まとめ
24. ① まずは、V8をビルドする
25. ①で扱うDocsのセクション
26. ① まずは、V8をビルドする ⽤意するもの • どのご家庭にもあるM4 Max搭載MBP • gitやXCodeなど • V8のソースコード ◦ https://chromium.googlesource.com/v8/v8.git
27. ① まずは、V8をビルドする 全て揃えたら • tools/dev/gm.py x64.release • 20分待ったらビルド完了 • PCが激アツになるので⽬⽟焼きでも作ってください🍳 • M1ならarm64ビルドの⽅がよかった
28. ① まずは、V8をビルドする JSが実⾏できた🎉
29. ① まずは、V8をビルドする ちなみに d8の「8」って何？
30. ① まずは、V8をビルドする 正解は... d8 = developer (諸説ある)
31. ② 開発の準備とデバッグ
32. ②で扱うDocsのセクション
33. ② 開発の準備とデバッグ コミッターになる条件が明記してある • 20個の重要なパッチ • 異なる3⼈からのレビュー • からのコミッターからの推薦
34. ② 開発の準備とデバッグ JSだけでなくWASMの実装にも関⼼を持っている • それぞれ標準化団体によるレビューがある ◦ JS側：TC39 ◦ WASM側：WASM CG • WASMのリリース前チェック ◦ “設計に⾃信があれば”チェックのプロセスを無視できる
35. ② 開発の準備とデバッグ Stack Trace API • error.stack 製造機 • V8のStack Traceはただの⽂字列 ◦ なーんでだ？ • CallSite APIがStack Traceの正体 ◦ JSの構⽂を取得‧判定するgetterが⽣えまくっている
36. ② 開発の準備とデバッグ クロスコンパイルなしのデバッグ(ARM) • ビルドに登場したgmで、x64上でarm64ビルドできる ◦ シミュレーターによるビルド • GDBっぽいコマンドも ◦ printobject, trace, break
37. ② 開発の準備とデバッグ GDBによるデバッグ • GDBで詳細なStack Traceを出せる • GDBは便利だが、実はパフォーマンスの制限がある ◦ 元は、⽣成されたバイナリに使うもの ◦ 細かくどんどんバイナリを⽣み出すJITと相性が悪い
38. ③ APIに触れる
39. ③で扱うDocsのセクション
40. ③ APIに触れる V8を組み込むということの具体 • JSからV8 API(C++)の実装を呼び出す • C++からV8 APIを呼び出す
41. ④ まとめ 例：JSからC++呼んでメモリリークの調査（Natives Syntax）
42. ④ まとめ 例：V8をVMとして、C++でHello World（107⾏！）
43. ④ まとめ 信頼できないコードへの対策 • TurboFan(後編で深掘り)がSSCAに対して弱い場合がある ◦ JSやWASMでV8内部をハックできる • 対策 ◦ 対策⽤フラグで抑制 ◦ サンドボックス（プロセス分離） ◦ ⾼精度タイマーの調整（Spectreの⽂脈で出てくるアレ）
44. ④ まとめ
45. ④ まとめ V8のDocs（の前半）を読むとできること • V8をビルドして実際に動かす • 不具合調査やあわよくば修正 • V8 APIをC++やJSから呼び出して組み込み（HelloWorld級）
46. 予告
48. Isolate？(local,eternal) handle？？ context？？？template？？？？
50. CSA？ASM？？Torque？？？
51. 次回 見知らぬ、 言語
52. 終 参考‧⽂献 ━━━━━ Ⓥ⑧ ⒹⒺⓋ
53. ありがとうございました