json

JSON parsing and serialization.

Import

import json

Functions

json.parse(str: str) -> any

Parse a JSON string into an XS value. Raises JsonError on invalid input.

json.parse_safe(str: str) -> any

Same as parse but returns null instead of raising on invalid input.

json.stringify(val: any) -> str

Serialize an XS value to a compact JSON string.

json.pretty(val: any) -> str

Serialize to JSON with indentation for readability.

json.valid(str: str) -> bool

Check if a string is valid JSON without parsing it.

Examples

scratch.xs

import json

let s = json.stringify(#{"a": 1, "b": [1, 2, 3]})
println(s)                       -- {"a":1,"b":[1,2,3]}

let m = json.parse(s)
println(m["a"])                  -- 1
println(m["b"][1])               -- 2

println(json.valid("[1,2,3]"))   -- true
println(json.valid("oops"))      -- false

let bad = json.parse_safe("not json")
println(bad)                     -- null

println(json.pretty(#{"x": 1, "y": 2}))

Edit this page on GitHub ->