Ga naar de inhoud
FrAIFlow

Oplossingen

Waarom JSON-ID's veranderen na het parsen

Een lang JSON-identificatienummer kan veranderen voordat je formatter het toont. JavaScript Number kan niet elk geheel getal boven 9007199254740991 exact weergeven. Als een identificatie in dat type terechtkomt, kan een keurig opgemaakt resultaat al andere cijfers bevatten.

Openbare meldingen beschrijven hoe JSON.parse grote getallen verandert en hoe precisie verloren gaat in Google Apps Script. In een opgeslagen Node.js-test werd het numerieke 9007199254740993 geparst als 9007199254740992, terwijl de string tussen aanhalingstekens zijn cijfers behield. Dit gecontroleerde resultaat is geen test van een live-API of van de huidige FrAIFlow-formatter.

Voorkom afronding voordat je de JSON-uitvoer opmaakt

Stel dat een bestel-ID in de respons eindigt op 993, maar na het importeren op 992. Vergelijk eerst de ongewijzigde respons met het geparste object. Een formatter kan een al afgeronde waarde niet herstellen. Bewaar het oorspronkelijke responsbestand en open of bewaar het tijdens het onderzoek niet via een andere numerieke importer.

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

Voor een identificatiecode is de tweede vorm doorgaans geschikt: een string bewaart alle cijfers. Vraag de API-maker het ID tussen aanhalingstekens te zetten en controleer daarna elke afnemer: een latere Number(id) of spreadsheetimport kan de reparatie ongedaan maken. Een klantcode wordt niet ineens een hoeveelheid omdat deze uit cijfers bestaat.

Kun je de bron niet aanpassen, kies dan een parser die de oorspronkelijke cijfers bewaart. Eerst afronden en dat achteraf herstellen werkt niet. In runtimes die dit ondersteunen kan een bronbewuste reviver het oorspronkelijke token lezen. Het onderstaande voorbeeld behandelt bewust alleen een veld met de naam id; pas het aan je schema aan in plaats van elk getal te converteren.

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

Controleer een waarde net onder en net boven de grens voor veilige gehele getallen en exporteer en importeer daarna een voorbeeld opnieuw. Elk cijfer moet overeenkomen met de bron. Wil je rekenen in plaats van identiteit bewaren, kies dan bewust voor BigInt of een decimale aanpak en bepaal hoe de uitvoer wordt geserialiseerd. Zet een afgeronde Number niet om in BigInt in de veronderstelling dat de verloren precisie dan terugkomt.

Welke cijfers verloren kunnen gaan bij omzetting naar een getal

Een gewone reviver ontvangt na het parsen een Number: te laat om verdwenen cijfers terug te halen. De bronbewuste aanpak hierboven hangt af van runtime-ondersteuning en het veldschema. Gebruik anders een parser die tokens bewaart. Zet numerieke tokens niet met een brede reguliere expressie tussen aanhalingstekens: die kan ook geciteerde inhoud veranderen of velden die echt numeriek moeten blijven.

Numeriek JSON-token / 9007199254740993 / Geparst: 9007199254740992
Uitleg gemaakt door de auteur, geen schermafbeelding van een toepassing.

Maak voor berekeningen BigInt vanuit de oorspronkelijke decimale string, niet vanuit een al afgeronde Number. Plan serialisatie expliciet: gewone JSON.stringify serialiseert BigInt-waarden niet rechtstreeks. Weergaveopmaak of achteraf nullen toevoegen herstelt de oorspronkelijke identiteit niet.

Uitlegdiagram: het getal 9007199254740993 wordt als Number afgerond naar 9007199254740992; als string blijven alle cijfers behouden.
Uitlegdiagram: het getal 9007199254740993 wordt als Number afgerond naar 9007199254740992; als string blijven alle cijfers behouden. Uitlegdiagram, geen schermafbeelding van een toepassing.
Vastgelegde Node.js-uitvoer: de numerieke JSON-code eindigt na het parsen op 992; de string behoudt de oorspronkelijke laatste cijfers 993.
Vastgelegde Node.js-uitvoer: de numerieke JSON-code eindigt na het parsen op 992; de string behoudt de oorspronkelijke laatste cijfers 993. Opgeslagen uitvoer van een gecontroleerde test, niet de toepassing uit de gebruikersmelding.
Bronnen, voorbeelden en meer informatie