Frequently Asked Questions
What happens to null values when I convert JSON to TOML?
They are emitted as empty strings. The tool even tells you that in the success status because TOML does not have a native null type.
How does it represent an array of objects?
An array whose items are all plain objects is serialized as TOML array-of-table blocks using [[name]]. That maps cleanly to common config-style TOML.
Why does nested JSON turn into [section] headers instead of inline objects?
Top-level nested objects are serialized as TOML tables, so you get section headers. Inline object syntax is mainly used when an object appears where the serializer treats it as a scalar value.
Can I convert any JSON shape?
It works best with a JSON object at the top level, because the serializer is designed around object properties becoming TOML keys and tables. Odd top-level structures are not what this component is optimized for.
Will it tell me exactly what is wrong with my JSON?
Yes, insofar as JSON.parse does. If the JSON is invalid, the tool surfaces the native parse error and clears the output.