Så här använder du det
- Klistra in ett JSON-objekt eller testa exemplet.
- Aktivera Utelämna null-värden om din JSON innehåller null-värden du inte behöver.
- Kopiera TOML:en eller ladda ned den som en .toml-fil.
Så fungerar det
JSON tolkas strikt och skrivs sedan som TOML 1.0 med smol-toml, ett bibliotek med öppen källkod. Nästlade objekt blir [tables], arrayer med objekt blir [[arrays of tables]], och nycklar som inte är vanliga ord omges med citattecken.
TOML kan inte uttrycka allt som JSON kan. Dokumentroten måste vara en tabell, så en JSON-array eller ett enskilt värde avvisas. Det finns ingen null i TOML: som standard rapporteras den första null med sin sökväg; du kan i stället välja att utelämna null-medlemmar i objekt. En null inuti en array är alltid ett fel, eftersom borttagning av den skulle ändra positionerna för de övriga elementen. Arrayer som blandar typer (till exempel tal och strängar) är giltiga i TOML 1.0 men inte i den äldre version 0.5, så de räknas upp i en anteckning.
JSON skiljer inte 1 från 1.0, så heltal skrivs som TOML-heltal. Strängar som ser ut som datum förblir strängar. Den andra riktningen är TOML till JSON.
Exempel
Appinställningar
{"server": {"host": "0.0.0.0", "port": 8080}} blir en [server]-tabell med nycklarna host och port.
Lista över arbetare
"workers": [{"queue": "mail"}, {"queue": "images"}] blir två [[workers]]-block.
Vanliga frågor
Varför tillåts inte null?
TOML har inget null-värde. Utelämna nyckeln eller använd ett värde som en tom sträng, beroende på vad det läsande programmet förväntar sig.
Varför visas en anteckning för en array med tal och strängar?
Arrayer med blandade typer tillåts sedan TOML 1.0, men verktyg som implementerar TOML 0.5 avvisar dem. Anteckningen hjälper om ditt målverktyg är äldre.
Kommer 1.0 att förbli ett flyttal?
Nej. JSON lagrar 1.0 och 1 som samma tal, så det blir heltalet 1. Skriv 1.5 eller redigera TOML-filen om programmet som läser den behöver ett flyttal.
Integritet
Konverteringen sker helt i din webbläsare. Din JSON och TOML laddas inte upp eller lagras.