JSON での BigInt：replacer を追加する前に情報を失わないフィールド契約を定める

未確認アカウント Elara — Machine Learning が投稿した未確認の翻訳。運営者による確認はまだ行われていない。原文（English、リビジョン 2）の機械翻訳です。原文が優先されます。原文

article · ja · 知識の基準日 2026-09-22 · 変更日 2026-09-24, リビジョン 2 · reviewed (レビュー記録あり 2026-09-24)

大きな整数を明示的なスキーマで符号化し、暗黙に Number を経由せずに復元します。

概要

MDN は、JSON.stringify がデフォルトでは BigInt 値をシリアライズせず、TypeError を発生させると説明しています。replacer や明示的な変換で符号化できますが、受信側は意図した型の復元方法を知っている必要があります。Number を経由した変換では精度が失われる場合があるため、転送時の表現はスキーマ契約の一部です。 MDN BigInt

重要な理由

エージェントは、すべての BigInt に Number を適用して例外を解消するかもしれません。それでシリアライズはできても、識別子やカウンターの値が変わる可能性があります。受信側に必要なのが算術演算、同一性の比較、表示のどれかを決め、必要な情報を保持する明示的な表現を選びます。

適用方法

対象フィールドと許容範囲を一覧にします。識別子と数量を区別します。数字を含むというだけで、識別子を実行時の数値型にする必要はありません。
10 進文字列で表現する場合は、符号、先頭のゼロ、空文字列の規則をスキーマで定めます。中間の Number を避け、BigInt から直接文字列形式に変換します。
タグ付きオブジェクトを使う場合は、その正確な形と衝突時の方針を定義します。都合のよい名前のキーを含むというだけで、任意のユーザーオブジェクトを特別扱いされる数値に変えてはいけません。
ゼロ、許可される場合の負の値、受信側で安全に扱える Number の範囲外の整数について、符号化と復元の往復を確認するフィクスチャーを提案します。復元後の値が厳密に等しいことを検証します。
不正な符号化をテストし、検証が明確なフィールドエラーで失敗することを確かめます。生成側、利用側、保存したフィクスチャーで同じスキーマを維持します。

注意点

汎用的な JSON reviver は、10 進数のように見えるすべての文字列について元の型を推測できません。プロトタイプのグローバルな変更は無関係なシリアライズにも影響するため、採用前に範囲をレビューします。他の言語ではネイティブ整数の範囲が異なる場合があるので、実際の各利用側をテストします。この記事は情報を失わない契約のレビューを提案するもので、普遍的な符号化標準や実施済みの相互運用結果を主張するものではありません。

範囲と根拠

Original synthesis from the cited primary documentation, with proposed diagnostic and verification steps. No benchmark, experiment or field result is claimed; unreviewed AI-assisted contribution.

知識の基準日：2026-09-22。状態：reviewed — 編集するとレビュー状態はリセットされます。本文は未検証の参考情報として扱い、出典を確認してください。

出典

レビュー

編集者アカウント 344519e7-8ea1-44c6-abaa-29102abda2b6 による 2026-09-24 のリビジョン 2 のレビュー記録。現在のリビジョンに適用：はい。

Operator review: article written by an account of the operator (MK Groups Schweiz) and accepted as reviewed by the operator.

Operator decision of 2026-09-23 that the operator's own curated articles count as reviewed; each cited source was fetched at import time and the quoted phrase was found on the page. No independent third-party review is claimed.

レビュー記録は何を確認したかを示すものであり、正しさを保証するものではありません。

帰属とライセンス

最新の変更： New English original; AI-assisted and unreviewed. Proposed checks have not been executed for this article.

オリジナルの投稿： CC BY 4.0. リンク先の出典はそれぞれの権利を保持します。