Share
Embed
Math.sumPreciseから学ぶ、ECMAScript仕様の数値の種類
JSConf JP 2026の発表資料です
https://jsconf.jp/2026/ja/talks/syumai
syumai
November 21, 2026
Transcript
45 slides
-
whoami syumai LayerX ソフトウェアエンジニア バクラクヘルプデスク エージェントを開発中 『[入門] Cloudflare Workers』著者 Asakusa.go
/ ECMAScript 仕様輪読会 主催 X: @__syumai Website: https://syum.ai © LayerX Inc. -
今日話すこと ECMAScript仕様に現れる数値の種類 ECMAScript language types と specification types 仕様中での数値の表記・変換 "任意の実数"が扱えるとはどういうことか
Math.sumPrecise の仕様を読む © LayerX Inc. 3 -
4種類の数値 Mathematical values 任意の実数。仕様の中で使うデフォルトの数値の種類。 Extended mathematical values Mathematical values に
+∞ と -∞ を加えたもの。 Numbers IEEE 754-2019 の binary64(倍精度浮動小数点数)の値。 BigInts 任意の整数と 1 対 1 に対応する ECMAScript language values。 © LayerX Inc. 7 -
4種類の数値 Mathematical values → 仕様上にのみ現れる Extended mathematical values → 仕様上にのみ現れる
Numbers → コードから直接扱える BigInts → コードから直接扱える © LayerX Inc. 8 -
2種類の型 ECMAScriptのアルゴリズムが扱う値にはすべて型があり、その型は ECMAScript language types と specification types のどちらかに分類される ECMAScript
language types ECMAScript の コードで直接扱われる値 の型 Undefined, Null, Boolean, String, Symbol, Number, BigInt, Object の8種類 ECMAScript specification types ECMAScriptの構文や、language typesに対応する値のセマンティクスをアルゴリズムで説明するために使う、 メタ的な値 の型 仕様中にしか現れない © LayerX Inc. 12 -
数値の分類 Number, BigIntは明示的にlanguage typesとして列挙されている Mathematical values, Extended mathematical valuesは、specification typesに列挙さ
れていない 「型はECMAScript language typesと specification typesのどちらかに分類される」との定義から、本セッショ ンではこれらをspecification typesとして扱う © LayerX Inc. 13 -
4種類の数値 Mathematical values → 仕様上にのみ現れる Extended mathematical values → 仕様上にのみ現れる
Numbers → コードから直接扱える BigInts → コードから直接扱える © LayerX Inc. 14 -
4種類の数値 Mathematical values → ECMAScript specification types Extended mathematical values
→ ECMAScript specification types Numbers → ECMAScript language types BigInts → ECMAScript language types © LayerX Inc. 15 -
Math.sumPrecise冒頭の specification typesの例 下線部がspecification types sans-serif体で記述されているのは Enum 特に注記のついていない数値は Mathematical values
ECMAScript仕様では、字体によって値の種 類を区別することがよくある点に注意 https://tc39.es/ecma262/#sec-math.sumprecise © LayerX Inc. 18 -
数値の表記 下付きの接尾辞でその種類を明示する 接尾辞 なし 𝔽 ℤ 種類 Mathematical value Number
BigInt 例 0, 253, 0x10FFFF +0𝔽, -0𝔽, 1𝔽, +∞𝔽 0ℤ, 1ℤ ECMAScript language values (Number, BigIntなど) は太字で書かれる © LayerX Inc. 以降のスライドもこれに揃える 20 -
数値の変換 数値の変換は必ず明示される (暗黙の変換はない) 記号による表記 𝔽(x) ℤ( x ) ℝ( x
) 文章による表記 the Number value for x the BigInt value for x the mathematical value of x 変換 (extended) mathematical value → Number integer → BigInt Number / BigInt → mathematical value 補足: integer = 整数であるMathematical value © LayerX Inc. 21 -
ECMAScript仕様上の数値受け渡しの読み方のコツ 関数の引数など、外部から入ってくる数値はNumberかBigInt 計算が必要になるタイミングで、多くの場合 ℝ(x) でMathematical valueに変換される ここで任意精度の計算になったと読む 返す時は大体 𝔽(x) でNumberに変換される
(x) でBigIntに変換されるのはごく一部 ℤ この辺りを意識して数値の受け渡され方を追うと読みやすい © LayerX Inc. 22 -
"任意の実数"が扱えるとはどういうことか? Numberの精度は有限 精度53bit 整数を正確に表せるのは ±253 まで ( Number.MAX_SAFE_INTEGER は 253
- 1) Mathematical valuesは任意の実数を表現できるので、Numberでは精度が失われるよ うな計算も可能 © LayerX Inc. 24 -
Numberで精度が失われる例 Number 0.1𝔽 + 0.2𝔽 = 0.30000000000000004𝔽 253𝔽 + 1𝔽
= 253𝔽 1016𝔽 + 1𝔽 - 1016𝔽 = +0𝔽 Numberでの計算では、精度が失われることがある 0.1も0.2も正確に表せない 253を超えると、表せない整数が出てくる 大きな値との計算で、小さな値が消える © LayerX Inc. 25 -
Mathematical valuesで計算した場合のイメージ Number 0.1𝔽 + 0.2𝔽 = 0.30000000000000004𝔽 253𝔽 +
1𝔽 = 253𝔽 1016𝔽 + 1𝔽 - 1016𝔽 = +0𝔽 Mathematical values 0.1 + 0.2 = 0.3 253 + 1 = 253 + 1 1016 + 1 - 1016 = 1 Mathematical valuesでの計算では、精度が失われない © LayerX Inc. 26 -
NumberをMathematical valuesに変換して計算した場合のイメージ Number 0.1𝔽 + 0.2𝔽 = 0.30000000000000004𝔽 253𝔽 +
1𝔽 = 253𝔽 1016𝔽 + 1𝔽 - 1016𝔽 = +0𝔽 Mathematical values 𝔽(ℝ(0.1𝔽) + ℝ(0.2𝔽)) = 0.30000000000000004𝔽 𝔽(ℝ(253𝔽) + ℝ(1𝔽)) = 253𝔽 𝔽(ℝ(1016𝔽) + ℝ(1𝔽) - ℝ(1016𝔽)) = 1𝔽 途中の計算では精度が失われないが、入力と出力では丸めが起きる Math.sumPreciseの仕様はこちらのイメージに近い © LayerX Inc. 27 -
Math.sumPreciseとは Numberのiterableを受け取り、途中で精度を失わずに合計し、正確な和に最も近い Numberを返す TC39 proposal (champion: Kevin Gibbons) 2025年7月にStage 4に到達し、ES2026に入った
Firefox 137 / Chrome 147 / Safari 26.2 で利用可能 https://github.com/tc39/proposal-math-sum © LayerX Inc. 30 -
Math.sumPreciseとは : Numberのiterable (Number以外が含まれると TypeError ) 戻り値: 合計値のNumber (空の場合は -0
) items https://tc39.es/ecma262/#sec-math.sumprecise https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Math/sumPrecise © LayerX Inc. 31 -
Math.sumPreciseという名前になった経緯 Stage 1 (2023-11) の時点の名前は Math.sum だった Stage 2 (2024-02)
で Math.sumExact に改名 a + b + c のような計算と同じ結果にはならないので、それがわかる名前にした方がよい、という提案 Stage 2.7 (2024-04) で Math.sumPrecise に改名 exact は実現できる以上のことを約束している、という指摘 exact だと 0.1 + 0.2 = 0.3 になると期待されてしまう、という懸念 proposal-math-sum#3 / TC39 notes 2024-02-06 / TC39 notes 2024-04-09 © LayerX Inc. 32 -
まとめ ECMAScriptの仕様中に現れる値の型は、ECMAScript language typesとspecification typesの2種類に分類される 数値の種類は、Mathematical values、Extended mathematical values、Number、 BigIntの4つ
Mathematical valuesは任意の実数を表現できる Math.sumPreciseの仕様は、Mathematical valuesの性質を活用して書かれている © LayerX Inc. 41 -
補足: 実装は任意精度演算でなくてよい The value of sum can be computed without
arbitrary-precision arithmetic by a variety of algorithms. One such is the "Grow-Expansion" algorithm given in Adaptive Precision Floating-Point Arithmetic and Fast Robust Geometric Predicates by Jonathan Richard Shewchuk. A more recent algorithm is given in "Fast exact summation using small and large superaccumulators", code for which is available at https://gitlab.com/radfordneal/xsum. 仕様はMathematical valuesで結果を定義しているだけで、計算方法は定めていない 任意精度演算を使わなくても、同じ結果を得るアルゴリズムがある https://tc39.es/ecma262/#sec-math.sumprecise © LayerX Inc. 44 -
補足: 正確な合計を返す仕様になった経緯 当初案では、精度の改善は実装依存、またはNeumaier法 (Kahan summationの変種) を 想定していた Stage 1の議論 (2023-11)
で方針が変わった 「特定のアルゴリズムを指定すると、誤った答えになるケースが残る。入力の数学的な和を最も近いdoubleに丸 めた値を、出力として指定すべき」(Waldemar Horwat) エンジン間で結果が変わらないよう、完全に決定的であるべきという意見が多数 仕様には結果だけを書き、アルゴリズムはNOTEで紹介するに留めた proposal-math-sum#1 / TC39 notes 2023-11-28 / TC39 notes 2024-02-06 © LayerX Inc. 45