Json

const Json: object

Defined in: Data/Json.ts:24

Pure, non-throwing JSON utilities. Wraps runtime JSON parsing and stringifying in typed Result containers.

Type Declaration

parse

parse: (text) => Result<SyntaxError, unknown>

Safely parses a JSON string into unknown. Converts thrown exceptions into a Result<SyntaxError, unknown>.

Parameters

text

string

Returns

Result<SyntaxError, unknown>

Example

Json.parse('{"a": 1}'); // Ok({ a: 1 })
Json.parse('{invalid}'); // Err(SyntaxError)

stringify

stringify: (value, replacer?, space?) => Result<TypeError, string>

Safely stringifies a value into a JSON string. Converts thrown exceptions (e.g. circular references) into a Result<TypeError, string>.

Parameters

value

unknown

replacer?

(this, key, value) => any

space?

string | number

Returns

Result<TypeError, string>

Example

Json.stringify({ a: 1 }); // Ok('{"a":1}')

Example

import { Json } from "@nlozgachev/pipelined/data";
import { pipe } from "@nlozgachev/pipelined/composition";

const result = pipe(
  Json.parse('{"name":"Alice"}'),
  Result.map((data: any) => data.name)
); // Ok("Alice")