Omvormen naar NDJSON

Zet CSV, INI, JSON, TOML, TSV, XML of YAML om naar NDJSON, oftewel JSON met één waarde per regel. Plak de bron of open een lokaal bestand en stel daarna de parser in. De omzetting gebeurt in je browser. De invoer wordt niet geüpload.

Hoe het omzetten werkt

Bij een array op het hoogste niveau schrijft de omzetter ieder item als een compacte JSON-waarde op een eigen regel. Een object of eenvoudige waarde op het hoogste niveau levert één regel op. De omzetter plaatst geen blokhaken om de uitvoer en zet geen komma’s tussen records.

CSV- en TSV-tabellen worden één object per regel als de eerste rij koppen bevat. Punten in een kop maken geneste eigenschappen. Kolommen met hetzelfde pad worden in één object samengevoegd. Zonder koppen wordt iedere rij een JSON-array. Typeherkenning kan herkenbare getallen, booleaanse waarden en nullwaarden omzetten in JSON-datatypen in plaats van tekenreeksen. Voor CSV kun je ook het scheidingsteken kiezen.

JSON-arrays worden over regels verdeeld. JSON-objecten en eenvoudige waarden blijven op één regel. TOML-tabellen, INI-secties en YAML-mappings worden omgezet naar één JSON-object, tenzij de parser een array of reeks oplevert. XML-elementen worden objecteigenschappen, herhaalde elementen worden arrays en attributen komen onder de ingestelde attributensleutel.

NDJSON-uitvoer

NDJSON wordt ook JSON Lines of JSONL genoemd. Iedere regel is een volledige JSON-waarde die een parser kan lezen zonder de aangrenzende regels nodig te hebben.

{"id":1,"naam":"Jan","actief":true}
{"id":2,"naam":"Sofie","actief":false}

De uitvoer gebruikt compacte JSON zonder inspringing. Tekenreeksen en eigenschapsnamen staan tussen dubbele aanhalingstekens. Gereserveerde tekens in tekenreeksen worden volgens de JSON-regels gemaskeerd. De omzetter zet een regeleinde tussen waarden en voegt geen extra regeleinde aan het einde toe.

Records en waarden op het hoogste niveau

NDJSON bevat meestal objecten met een vergelijkbare structuur, maar het formaat staat iedere JSON-waarde per regel toe. Deze omzetter kan daarom ook arrays, tekenreeksen, getallen, booleaanse waarden en null als records schrijven. Sommige importprogramma’s verwachten op iedere regel een object. Controleer daarom de eisen van de software die het bestand gaat lezen.

Een lege array op het hoogste niveau levert lege uitvoer op. Lege CSV- of TSV-invoer levert ook geen records op. Een enkel object wordt één regel en niet één regel per eigenschap.

Waar NDJSON wordt gebruikt

NDJSON past bij logboeken, exports van gebeurtenissen, commandopijplijnen, bulkverzoeken aan API’s en datasets die record voor record worden verwerkt. Software kan een regel lezen, de JSON-waarde verwerken en doorgaan zonder eerst één grote buitenste array te ontleden. Een record toevoegen is ook eenvoudig, omdat er geen afsluitende blokhaak of laatste komma hoeft te veranderen.

Dit browserhulpmiddel houdt de volledige bron en uitvoer toch in het geheugen. Het streamt bestanden niet regel voor regel. Gebruik daarom een streamingprogramma voor exports die te groot zijn voor een browsertabblad.

Wat verloren kan gaan

De omzetting behoudt waarden die JSON kan vastleggen, maar geen commentaar, witruimte of bronopmaak. Datumachtige TOML- en YAML-waarden lopen via het datamodel dat de parsers ondersteunen. YAML-ankers, aliassen, tags en scalaire stijlen vervallen. XML-commentaar, verwerkingsinstructies, naamruimten, gemengde inhoud en het verschil tussen CDATA en gewone tekst zijn niet te reconstrueren.

CSV en TSV bevatten geen ingebouwde type-informatie. Zonder typeherkenning blijven 25, true en null JSON-tekenreeksen. Met typeherkenning wordt tekst die overeenkomt met een ondersteunde JSON-waarde omgezet naar dat datatype. Grote gehele getallen lopen via JavaScript, dat niet ieder geheel getal boven 9.007.199.254.740.991 exact kan vastleggen.

Bestanden, privacy en opgeslagen werk

Kies een lokaal bestand om het in de omzetter te laden. Een herkende extensie selecteert het bijbehorende invoerformaat. De browser leest het bestand lokaal en uploadt het niet.

Het gekozen formaat, de invoer per formaat en parserinstellingen staan in localStorage. Wisselen van formaat overschrijft geen tekst van een ander formaat. Wis de velden of sitegegevens na verwerking van gevoelige informatie op een gedeeld apparaat.

Gerelateerde hulpmiddelen

• Omvormen naar CSV
• Omvormen naar INI
• Omvormen naar JSON
• Omvormen naar TOML
• Omvormen naar TSV
• Omvormen naar XML
• Omvormen naar YAML

Widget gemaakt met staark