Saltar al contenido
FrAIFlow

Soluciones

Por qué los identificadores JSON cambian al analizarlos

Un identificador largo de un JSON puede cambiar antes de que el formateador lo muestre. El tipo Number de JavaScript no puede representar exactamente todos los enteros superiores a 9007199254740991. Si un identificador se convierte a ese tipo, una salida aparentemente correcta puede contener ya otros dígitos.

Hay consultas públicas sobre JSON.parse que modifica números grandes y sobre pérdida de precisión en Google Apps Script. En una prueba guardada de Node.js, el número 9007199254740993 se interpretó como 9007199254740992, mientras que la cadena entre comillas conservó sus dígitos. Este resultado controlado no es una prueba de una API en funcionamiento ni del formateador actual de FrAIFlow.

Corrija la conversión antes de dar formato al resultado

Supongamos que un identificador de pedido termina en 993 en la respuesta, pero termina en 992 después de importarlo. Compare primero la respuesta sin modificar con el objeto analizado. Un formateador no puede reparar un valor que ya se ha redondeado. Conserve el archivo de respuesta original y, mientras investiga, evite abrirlo y guardarlo mediante otro importador que convierta sus valores en números.

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

Para un identificador, normalmente interesa la segunda representación. Pida al proveedor de la API que envíe el identificador entre comillas y revise todos los sistemas que lo consumen: una llamada posterior a Number(id) o una importación en una hoja de cálculo puede deshacer la corrección. Un código de cliente no se convierte en una cantidad solo porque contenga dígitos.

Si el proveedor no puede cambiarlo, no analice primero los datos para intentar repararlos después. En los entornos que lo admiten, una función reviver con acceso al texto de origen puede leer el token original. El ejemplo siguiente trata deliberadamente solo un campo llamado id; adáptelo al esquema de sus datos en lugar de convertir todos los números.

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

Compruebe un valor justo por debajo y otro justo por encima del límite de enteros seguros; después exporte y vuelva a importar una muestra. Cada dígito debe coincidir con el original. Si necesita hacer cálculos y no conservar una identidad, elija expresamente una estrategia con BigInt o decimales y decida cómo serializará el resultado. Convertir un Number redondeado en BigInt no recupera la precisión perdida.

Lo que puede perder una conversión numérica

Un reviver ordinario recibe un Number después del análisis: ya es demasiado tarde para recuperar los dígitos descartados. La alternativa anterior, que consulta el origen, depende de la compatibilidad del entorno y del esquema del campo. Si no está disponible, utilice un analizador que preserve los tokens. No añada comillas a los números mediante una expresión regular genérica: también podría alterar texto entre comillas o campos que realmente deben ser numéricos.

Token numérico JSON / 9007199254740993 / Tras analizar: 9007199254740992
Explicación elaborada por el autor, no una captura de una aplicación.

Para hacer cálculos, construya BigInt a partir de la cadena decimal original, no de un Number ya redondeado. Planifique expresamente la serialización: JSON.stringify no serializa directamente los valores BigInt. Un formato visual o un parche de ceros al final no puede restaurar la identidad original.

El número JSON 9007199254740993 se redondea a 9007199254740992; entre comillas conserva todos sus dígitos.
Ilustración explicativa en inglés. El número JSON 9007199254740993 se redondea a 9007199254740992; entre comillas conserva todos sus dígitos.
El resultado de Node.js compara el identificador redondeado como Number con el valor exacto conservado como cadena.
El resultado de Node.js compara el identificador redondeado como Number con el valor exacto conservado como cadena. Resultado del ejemplo sintético, no una captura de la aplicación del usuario. Abra la imagen para verla ampliada.
Fuentes, ejemplos y lecturas relacionadas