https://github.com/vnau/jsooner

Parse JSON streams faster.
https://github.com/vnau/jsooner

json json-parser jsooner npm-package parser streaming typescript

Last synced: 4 months ago
JSON representation

Parse JSON streams faster.

• Host: GitHub
• URL: https://github.com/vnau/jsooner
• Owner: vnau
• License: mit
• Created: 2024-10-28T01:16:27.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2026-02-23T18:37:56.000Z (4 months ago)
• Last Synced: 2026-03-01T16:56:39.316Z (4 months ago)
• Topics: json, json-parser, jsooner, npm-package, parser, streaming, typescript
• Language: TypeScript
• Homepage:
• Size: 134 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# jsooner

[![npm](https://img.shields.io/npm/v/jsooner?color=brightgreen&logo=npm)](https://www.npmjs.com/package/jsooner)

![coverage](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/vnau/7353726794cee33914eb47e39e6694c6/raw/jsooner__heads_main.json)

[![bundle size](https://badgen.net/bundlephobia/min/jsooner)](https://bundlephobia.com/package/jsooner)

`jsooner` is a lightweight, efficient library for parsing large JSON streams.

It’s specifically designed for handling long sequences of JSON objects in a fast and memory-efficient way, without aiming to be a full-featured JSON parser.

## Why jsooner?

Parsing large JSON files or continuous streams can overwhelm standard methods like `JSON.parse`, especially in terms of memory and speed. `jsooner` addresses these challenges with:

- _Efficiency:_ Parses JSON incrementally as data arrives, outperforming `JSON.parse` on streams.

- _Memory Optimization:_ Handles streaming data with minimal memory usage

## Installation

You can install `jsooner` via npm:

```bash

npm install jsooner

```

## Usage

Here's a basic example of how to use `jsooner`:

```TypeScript

import { toJsonAsyncIterable } from "jsooner";

const response = await fetch("https://raw.githubusercontent.com/vnau/jsooner/refs/heads/main/examples/data/point-samples.geojson");

const features = toJsonAsyncIterable(response, { lookup: '"features"' });

for await (const feature of features) {

    console.log(feature);

}

```

## Performance

`jsooner` has been benchmarked against other JavaScript parsers that support streaming, as well as the native `JSON.parse` method, to demonstrate its efficiency with large JSON files.

The benchmarks were conducted on a [136 MB GeoJSON file](https://data-nces.opendata.arcgis.com/api/download/v1/items/6a4fa1b0434e4688b5d60c2e5c1dcaaa/geojson?layers=0) stored locally.

```mermaid

xychart-beta horizontal

    title "Parsing Time"

    x-axis [JSON.parse, jsooner, "streamparser/json", oboe, stream-json]

    y-axis "Time, s" 0 --> 30

    bar [1.78, 2.86, 6.94, 8.43, 25.4]

```

```mermaid

xychart-beta horizontal

    title "Parsing Memory"

    x-axis ["streamparser/json", jsooner, stream-json, oboe, JSON.parse]

    y-axis "Resident Set, Mb" 0 --> 750

    bar [59, 62, 85, 625, 743]

```

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.