Ga naar de inhoud
FrAIFlow

Oplossingen

Waarom ogenschijnlijk geldige JSON al bij het eerste teken vastloopt

Je ziet een geldig JSON-object, maar krijgt toch een fout op positie nul. De openingsaccolade is mogelijk niet het eerste teken: ervoor kan een onzichtbare U+FEFF staan. Bewaar het origineel voordat je iets herstelt. Een HTML-inlogpagina, lege respons of verkeerd gedecodeerd bestand vraagt om een andere oplossing.

In een Stack Overflow-melding uit 2017 werd een vergelijkbare Node.js-fout herleid tot decimaal 65279, oftewel U+FEFF. Een opgeslagen lokale browsertest vormt apart bewijs: een synthetische U+FEFF gevolgd door {"ok":true} mislukte en kon vervolgens worden verwerkt nadat alleen het voorvoegsel was verwijderd. De schermafbeelding toont die lokale test, niet het bestand van de melder.

Een gerichte reparatie die je zelf kunt uitvoeren

Begin met een kopie van het bestand, niet je enige export. Komt de inhoud uit een webverzoek, controleer dan eerst de HTTP-status en het inhoudstype: een inlogpagina die begint met <!doctype html> vraagt om herstel van de authenticatie, niet om JSON-opschoning. Gebruik voor een lokaal bestand een editor die de codering kan tonen. Sla tijdens het onderzoek niet over het origineel heen op.

Heb je het bestand gedecodeerd naar een JavaScript-string met de naam text, gebruik dan de volgende kleine hulpfunctie in je eigen importscript. Die accepteert één bekende markering aan het begin en laat al het andere ongemoeid.

function parseJsonText(text) {
  if (typeof text !== "string") throw new TypeError("Expected text");
  const hadBOM = text.charCodeAt(0) === 0xFEFF;
  const cleaned = hadBOM ? text.slice(1) : text;
  return { value: JSON.parse(cleaned), removedLeadingBOM: hadBOM };
}
const sample = '\uFEFF{"ok":true,"name":"한글"}';
const result = parseJsonText(sample);
console.log(result.removedLeadingBOM); // true
console.log(result.value.ok);          // true
console.log(result.value.name);        // 한글

Een geslaagde controle is meer dan ‘de fout is weg’. Controleer of de verwachte eigenschappen bestaan en niet-Engelse tekst nog goed leesbaar is. Test de functie ook met gewone JSON: die moet worden verwerkt zonder melding dat een markering is verwijderd. Lege invoer en een ongeldig object moeten nog steeds een fout geven. Laat die fout zichtbaar voor de aanroeper in plaats van een leeg object terug te geven dat voor geldige gegevens kan worden aangezien.

Is het eerste codepunt geen U+FEFF, stop dan met deze herstelroute. Een bestand met een verkeerde decodering kan bijvoorbeeld vervangingstekens of afwisselende nultekens bevatten. Open het opnieuw met de codering die de exporterende toepassing gebruikt of vraag om een nieuwe UTF-8-export. Tekens verwijderen kan verkeerd gedecodeerde bytes niet reconstrueren.

Het verschil tussen bytes en een verborgen teken

Verborgen voorvoegsel / U+FEFF  {"ok":true} / JSON.parse → geweigerd
Uitleg gemaakt door de auteur, geen schermafbeelding van een toepassing.

TextDecoder("utf-8") laat een UTF-8-BOM aan het begin normaal weg. De optie ignoreBOM is verwarrend: true neemt de markering juist op in de gedecodeerde string. Ons bytevoorbeeld EF BB BF 7B 7D werd met het standaardgedrag {}. Dit is geen automatische herkenning van de codering.

Controleer de bron van het bestand

Een aparte PowerShell-melding ging over een onjuiste decodeerroute. Windows PowerShell Out-File en omleiding kunnen UTF-16LE produceren; nieuwere PowerShell-versies werken anders. Niet-ASCII-tekst verwijderen kan geldige namen beschadigen zonder dat verschil op te lossen. Controleer het gebruikte commando en de versie en decodeer of exporteer daarna correct. De werkwijze van die gebruiker is niet in onze test gereproduceerd.

RFC 8259 vereist UTF-8 voor JSON-uitwisseling buiten een gesloten ecosysteem en verbiedt producenten een BOM aan netwerkgegevens toe te voegen. Herstel indien mogelijk de exporter. Test bij de importgrens gewone JSON, het bevestigde voorvoegsel, ongeldige JSON en niet-Engelse waarden. Log alleen het diagnostische voorvoegsel, niet de privé-inhoud van documenten.

Uitlegdiagram: de UTF-8-BOM EF BB BF kan als U+FEFF aan het begin blijven staan. Alleen dat voorvoegsel wordt verwijderd, zodat JSON.parse het object kan lezen.
Uitlegdiagram: de UTF-8-BOM EF BB BF kan als U+FEFF aan het begin blijven staan. Alleen dat voorvoegsel wordt verwijderd, zodat JSON.parse het object kan lezen. Uitlegdiagram, geen schermafbeelding van een toepassing.
Vastgelegde browsertest: U+FEFF aan het begin veroorzaakt een JSON-fout; na gericht verwijderen wordt ok als true ingelezen.
Vastgelegde browsertest: U+FEFF aan het begin veroorzaakt een JSON-fout; na gericht verwijderen wordt ok als true ingelezen. Opgeslagen uitvoer van een gecontroleerde test, niet de toepassing uit de gebruikersmelding.
Bronnen, voorbeelden en meer informatie