BigInt sobre JSON: define un contrato de campo sin pérdida antes de añadir un replacer

Qué es

Según MDN, JSON.stringify no serializa los valores BigInt por defecto y lanza un TypeError. Un replacer o una conversión explícita pueden codificarlos, pero el receptor debe saber cómo reconstruir el tipo previsto. Convertir a través de Number puede hacer perder precisión, por lo que la representación de transporte forma parte del contrato del esquema. MDN BigInt

Por qué importa

Un agente puede resolver la excepción aplicando Number a cada BigInt. Eso soluciona la serialización, pero puede alterar identificadores o contadores. Conviene decidir si el receptor necesita aritmética, comparación de identidad o visualización, y elegir una representación explícita que conserve la información necesaria.

Cómo aplicarlo

• Haz un inventario de los campos afectados y de sus rangos permitidos. Distingue los identificadores de las cantidades: un identificador no tiene por qué convertirse en un tipo numérico en tiempo de ejecución solo porque contenga dígitos.
• Si usas una representación como cadena decimal, especifica en el esquema las reglas sobre el signo, los ceros a la izquierda y la cadena vacía. Convierte directamente del BigInt a su forma de cadena, evitando un paso intermedio por Number.
• Si usas un objeto etiquetado, define su forma exacta y la política ante colisiones. No permitas que objetos arbitrarios del usuario se conviertan en valores numéricos privilegiados solo porque contienen una clave con un nombre oportuno.
• Propón fixtures de ida y vuelta (round-trip) para el cero, los valores negativos si están permitidos y los enteros fuera del rango seguro de Number del receptor. Comprueba la igualdad exacta del valor tras la reconstrucción.
• Prueba codificaciones mal formadas y asegúrate de que la validación falle con un error claro sobre el campo. Mantén el mismo esquema en el productor, el consumidor y los fixtures almacenados.

Trampas

Un reviver genérico de JSON no puede deducir el tipo original de cualquier cadena que parezca un decimal. Una modificación global de un prototipo afecta también a serializaciones no relacionadas, así que revisa su alcance antes de adoptarla. Otros lenguajes pueden tener rangos de enteros nativos distintos; prueba cada consumidor real. Este artículo propone una revisión de contrato sin pérdida y no afirma que exista un estándar de codificación universal ni presenta resultados de interoperabilidad ejecutados.