JSONを解析するとIDの数字が変わる理由
JSONに含まれる長い識別子は、整形ツールが表示する前に変わっていることがあります。JavaScriptのNumberでは、9007199254740991を超える整数をすべて正確に表せません。IDをこの型に変換すると、出力がきれいに整っていても、すでに別の数字になっている可能性があります。
公開相談にはJSON.parseで大きな数が変わった例や、Google Apps Scriptで精度が失われた例があります。保存済みのNode.jsテストでは、数値9007199254740993が9007199254740992として解析されましたが、引用符で囲んだ文字列では全桁を保持できました。これは条件を限定したテストであり、実際のAPIや現在のFrAIFlow整形ツールを検証した結果ではありません。
出力の整形より先に、読み込み時の型を直す
たとえば応答にある注文IDの末尾が993なのに、取り込むと992になる場合です。まず手を加えていない応答と解析後のオブジェクトを比較してください。一度丸められた値は整形ツールでは直せません。元の応答ファイルを残し、調査中に別の数値インポーターで開いて保存し直すことも避けましょう。
const numeric = JSON.parse('{"id":9007199254740993}');
const exact = JSON.parse('{"id":"9007199254740993"}');
console.log(numeric.id); // 9007199254740992
console.log(exact.id); // 9007199254740993
console.log(typeof exact.id); // string識別子なら通常は二つ目の表現が適切です。APIの提供側にIDを引用符で囲むよう依頼し、その後すべての利用側を確認します。後段のNumber(id)や表計算への取り込みで、修正が無効になることがあるためです。数字だけの顧客コードでも、数量とは限りません。
提供側を変更できない場合、先に解析してから直そうとしてはいけません。対応する実行環境では、元のトークンを取得できるreviverが使えます。以下の例は意図的にidという名前のフィールドだけを処理しています。すべての数値を変換せず、自分のスキーマに合わせてください。
let supportsSource = false;
JSON.parse("1", (key, value, context) => {
supportsSource = context?.source === "1";
return value;
});
if (!supportsSource) throw new Error("Use a lossless JSON parser");
const record = JSON.parse('{"id":9007199254740993}',
(key, value, context) => {
if (key === "id" && typeof value === "number") {
if (!context || !/^-?\d+$/.test(context.source)) {
throw new Error("Expected a decimal integer ID");
}
return context.source; // Keep the exact token as a string.
}
return value;
});
console.log(record.id === "9007199254740993"); // true安全な整数の境界のすぐ下とすぐ上の値を試し、サンプルを書き出して再び読み込んでください。全桁が元データと一致する必要があります。識別ではなく計算に使うなら、BigIntや10進数の処理方式を明確に選び、出力時の形式も決めます。丸められたNumberをBigIntにしても、失われた精度は戻りません。
数値への変換で失われるもの
通常のreviverが受け取るのは解析後のNumberなので、失われた桁を復元するには遅すぎます。上の元トークンを使う方法は、実行環境の対応とフィールドのスキーマに依存します。未対応ならトークンを保持するパーサーを選びましょう。広い正規表現で数値らしい部分を一括して引用符で囲む方法は避けてください。文字列内の内容や、本当に数値であるべきフィールドまで変えてしまいます。
計算用のBigIntは、丸められたNumberではなく元の10進数字列から作ります。通常のJSON.stringifyはBigIntをそのまま直列化できないため、書き出し方法を明確に決めてください。表示形式の変更や末尾のゼロの補修で、元のIDを取り戻すことはできません。
