incomplete-json-parser

> A JSON parser that can parse incomplete JSON strings.

Demo

1. Incomplete JSON vs Parse-able JSON

!demo-small

2. Application example

What is incomplete-json-parser?

incomplete-json-parser is a TypeScript module that provides a streaming JSON parser. It can handle incomplete or chunked JSON data, making it useful for parsing JSON data that arrives in multiple parts or when dealing with large JSON files.

The parser is designed to be flexible and can handle various scenarios, such as:

- Incomplete JSON objects or arrays
- JSON data split across multiple chunks
- Incomplete string values

Installation

To install incomplete-json-parser, use the following command:

``bash
npm install incomplete-json-parser
yarn add incomplete-json-parser
`

Usage

Here's an example of how to use incomplete-json-parser:

`typescript
import { IncompleteJsonParser } from 'incomplete-json-parser';

const parser = new IncompleteJsonParser();

// Write incomplete JSON data to the parser
parser.write('{"name": "John", "age": 30, "city": "New');
parser.write(' York", "hobbies": ["reading", "gaming"');

// Get the parsed JavaScript object
const result = parser.getObjects();
console.log(result);
// Output: { name: 'John', age: 30, city: 'New York', hobbies: ['reading', 'gaming'] }
`

In this example, we create an instance of the IncompleteJsonParser and write incomplete JSON data to it using the write method. We can write data in multiple chunks, simulating a streaming scenario.

Once we have written all the necessary data, we call the getObjects method to parse the accumulated JSON data and retrieve the resulting JavaScript object.

API

$3

Creates a new instance of the IncompleteJsonParser.

$3

A static method that allows parsing JSON data in a single step. It creates a new instance of IncompleteJsonParser, writes the provided chunk to it, and returns the parsed JavaScript object.

$3

`typescript
const json = '{"name": "Alice", "age": 25, "city": "London"';
const result = IncompleteJsonParser.parse(json);
console.log(result);
// Output: { name: 'Alice', age: 25, city: 'London' }
`

$3

Resets the parser's internal state, clearing the buffer, accumulator, pointer, and path. This method is useful when you want to reuse the same parser instance for parsing multiple JSON objects.

$3

Writes a chunk of JSON data to the parser's internal buffer.

$3

Parses the accumulated JSON data and returns the parsed JavaScript object.

Examples

Here are a few more examples demonstrating the capabilities of incomplete-json-parser:

$3

`typescript
const parser = new IncompleteJsonParser();

parser.write('{"name": "Alice", "age": 25, "city": "London"');
const result = parser.getObjects();
console.log(result);
// Output: { name: 'Alice', age: 25, city: 'London' }
`

$3

`typescript
const parser = new IncompleteJsonParser();

parser.write('["apple", "banana", "orange"');
const result = parser.getObjects();
console.log(result);
// Output: ['apple', 'banana', 'orange']
`

$3

`typescript
const parser = new IncompleteJsonParser();

parser.write('{"message": "Hello, world!');
const result = parser.getObjects();
console.log(result);
// Output: { message: 'Hello, world!' }
`

$3

`typescript
const parser = new IncompleteJsonParser();

parser.write('{"value": n');
const result1 = parser.getObjects();
console.log(result1);
// Output: { value: null }

parser.write('{"value": nu');
const result2 = parser.getObjects();
console.log(result2);
// Output: { value: null }
``

Author

👤 Dante Chun

* Website: https://dante.company
* Github: @1000ship

🤝 Contributing

Contributions, issues and feature requests are welcome!
Feel free to check issues page.

Show your support

Give a ⭐️ if this project helped you!

📝 License

Copyright © 2024 Dante Chun.

This project is MIT licensed.