
2026/11/15 3:35
WebKit のバグを修正して、プロミスがレールで作られているか確認する
RSS: https://news.ycombinator.com/rss
要約▶
Japanese Translation:
Bun 1.3.14 および Safari 26 に存在した重大なバグは、getter ベースのロジックを使用した
Promise.resolve を用いたプログラムで、指定通りプロミスを拒否するのではなく永続的に止まってしまうという問題を引き起こしました。この問題は、JavaScriptCore が resolve/reject 関数を作成する前に constructor[Symbol.species] といったプロパティを読むように実装したファストパスの使用に起因していました。このプロパティアクセス中に getter がエラーをスローした場合、そのエラーは拒否トラック上で放置され、プロミスは「pending(保留)」状態のまま固定されるのではなく正常に解決しませんでした。Node.js/V8 は即時にエラーをスローする点を正しく処理しますが、これらのエンジン自体が例外を失敗トラックに注入するため、適切には取り扱えませんでした。この設計上の実態は、TypeScript の Promise<T> にエラー型パラメータがないこと、あるいは Rust の鉄道指向プログラミング(Railway Oriented Programming)における失敗が多種多様な源泉から生じ得ることに例示されています。バグは WebKit issue 318399として追跡され、resolve/reject 関数の作成を getter アクセスの順序前にずらすことで修正されました(パッチ +16 行)。この修正により、getter や thenable .then() 呼び出しからスローされたエラーが適切に処理されるようになります。解決策は Bun 1.4 および Safari 27 で利用可能になり、エンジンを実装側の要件と揃えることにより、「inner thenable が解決しない場合」「resolved(解決済み)」が直ちに最終性を示すわけではないという標準プロミス仕様の要求事項に合致させ、予期せざるフングを解消し、一貫した信頼性を確保しました。
- 欠落要素:上記のリスト参照
- 推測/飛躍:重要なものはなし
- 改善されたサマリー:上記のブロックに記載
本文
JavaScript Promises の奇妙なハング問題と WebKit 修正記
JavaScriptCore を搭載する Safari と Bun で発生する、Promise が「待機(Pending)」状態のままフリーズしてしまうバグについて解説します。
🐞 バグの再現コード
以下のコードを実行すると、Node.js では正常にエラーが発生しますが、Bun 1.3.14 および Safari 26 では
'before' を出力した後、エラーを表示してもプログラムがフリーズ(ハング)してしまいます。
const p = Promise.resolve(1); p.constructor = { get [Symbol.species]() { throw new Error("boom"); // ここからエラーが発生します }, }; console.log("before"); await p; // エラーがスローされ、プログラムはクラッシュするはず console.log("done");
仕様との乖離
JavaScript の仕様では、Promise のコンストラクターの
Symbol.species プロパティをゲッターとして読み取った際にエラーがスローされた場合、そのエラー自体を理由(reason)にして Promise を拒絶(reject)すべきです。しかし、Safari と Bun はこのエラー処理を正しく行わず、Promise が永遠に完了しません。
- 原因: WebKit のバグ 318399 です。
- 修正: WebKit/WebKit#68749 で修正済みです(コード増加 +16 行)。
🧠 Promise の仕組み:「平凡な Promise」の落とし穴
Promise は、値で満たされる(resolve)か、理由で拒絶される(reject)という 2 つの状態遷移を持つと一般的に考えられています。しかし、仕様上の動作はより複雑です。
Resolve Procedure
resolve(value) が呼び出された際、エンジンが行う処理フローは以下の通りです。
| 段階 | 動作 |
|---|---|
| 1. then の読み取り | プロパティをアクセスし、ゲッターを実行します。 |
| 2a. エラー発生時 | ゲッターがエラー(例外)をスローする場合 → Promise を拒絶する。 |
| 2b. 関数取得時 | が関数または非関数の場合 → value.then(resolve, reject) を呼ぶ。 |
重要なポイント:
- プロパティの読み取り(ゲッター実行)はエラーをスローできます。
- スローされたエラーは、拒絶の理由として処理されます。
は単純に値を保存するだけではありません。resolve(value)
平坦化(Flattening)と Thenable
外部から渡された Promise ではなく、Thenable(
.then() メソッドを持つオブジェクト)の場合、内部的な Promise がその Thenable を待機して結果を待つのではなく、「同化(Assimilation)」され、外部の Promise と平坦化されます。
const thenable = { then(resolve, reject) { resolve(42); // 外部のプロミスが解決する } }; await new Promise(resolve => resolve(thenable)); // 結果は 42
状態の誤解:Resolved vs Fulfilled
「Resolved(解決済み)」と「Fulfilled(満たされ完了)した」は異なります。Promise が
resolve() を呼ばれた直後でも、内部的な Promise が永遠に待機している場合、全体としては Pending 状態のままです。
const inner = new Promise(() => {}); // 決して解決されない const outer = new Promise(resolve => resolve(inner)); // outer は technically "Resolved" ですが、inner が待機しているため // 最終的な状態は Pending です。
🚂 鉄道図(Railways)による可視化
「鉄道指向型プログラミング(Railway Oriented Programming)」の概念を用いて、Promise の失敗を視覚化できます。
- 線路: 成功の線路(満たされる)と、失敗の線路(拒絶される)。
- 結合(Binding): 前のステップが成功すれば次へ、失敗すればエラー線路へ流れる仕組み(Rust の
や?
に相当)。and_then
[validate] -> [update] -> [send] (成功) (失敗) (次のステップはスキップされ、エラー線路に到達)
JavaScript の Promise も同様に、
.then() がスイッチ役を果たしています。
🛠️ バグの根源:Species ルックアップとタスクキュー
なぜ Safari/Bun でハングするのか?
Promise を解決する際に、JS エンジン(JavaScriptCore)が以下の順序で処理します。
- Species ロックアップ:
を読み取る(ゲッター実行)。constructor[Symbol.species] - 関数作成: 新しい
とresolve
の関数を生成する。reject - Thenable の呼出し:
を実行する。value.then(resolve, reject)
問題の所在: Safari/Bun (修正前) はステップ 1 でエラーが発生すると、ステップ 2(
resolve/reject 関数の生成)をスキップしていました。つまり、「拒絶するための関数」が存在しなかったため、ステップ C(エラーを理由として Promise を拒絶する処理)が実行できず、Promise は永久に Pending のまま成为了。
// 修正前の疑似コード(バグあり) if (speciesGetterThrows) { // resolve/reject 関数がまだ作成されていません! throw exception; // エラーはタスクから漏れ出し、処理が止まる } resolve(rejectedPromise);
修正後のフロー(仕様準拠):
- まず
とresolve
の関数を安全に生成する。reject - その後、Species ロックアップや Thenable の呼出しを行う。
- エラーが発生した際も、既に用意された
関数を使って Promise を拒絶できる。reject
[関数作成] -> [Thenable/Species アクセス] -> (エラーなら reject)
📝 TypeScript と失敗型(Error Type)の限界
Promise を鉄道図で表現できるものの、TypeScript では「失敗の線路」を型で明示する仕組みが標準にありません。
というインターフェースには成功値(T)しか指定できません。Promise<T>- 拒絶される可能性のある型(E)を含めることはできません(
は非公式)。Promise<T, E> - 理由: JavaScript のランタイムは、内部でエラーを捉えるため、外部から与えられた
(事実上any
)の失敗トラекにアクセスする必要があるためです。unknown
// 期待されているが仕様にはない形 declare const p: Promise<number, Error>; const value = await p; // エラーが発生した場合でも、型情報からは E が伝わらない
💡 まとめ
は即座に完了するのではなく、resolve(value)
の読み取りを含みます。value.then- プロパティの読み取り(ゲッター)でエラーがスローされた場合、それは Promise 拒絶の理由となります。
- Safari/Bun のバグ: Species ロックアップでエラーが発生した際に、拒絶用関数が未定義だったため処理が止まっていた。
- 修正: 関数作成を先にし、エラー発生時でも
が呼び出せるようにする。reject() - TypeScript では失敗の型(E)を追跡できないため、ランタイムレベルでエラー処理が発生する。
Promise の仕様は複雑ですが、これを「鉄道」として理解すると、なぜエラーが伝播するのか、そして今回のバグがなぜ致命的なハングになったのかを明確に理解できるようになります。