Socket
Socket
Sign inDemoInstall

zipson

Package Overview
Dependencies
Maintainers
1
Versions
13
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

zipson

JSON parse and stringify with compression


Version published
Weekly downloads
7.9K
increased by19.6%
Maintainers
1
Weekly downloads
 
Created
Source

 zipson

Build Status npm version devDependencies Status

Zipson is a drop-in alternative to JSON.parse/stringify with added compression and streaming support.

demo

Try the online demo


Installing

As an npm module

npm install --save zipson

Or alternatively from jsdelivr with a script tag as a UMD bundle

<script src="https://cdn.jsdelivr.net/npm/zipson@latest/dist/zipson.min.js"></script>

API

stringify(data, options?)

Stringify data to a zipson string

import { stringify } from 'zipson';

const myData = [1, 2, 3, 4 ,5];
const stringified = stringify(myData, options);
stringifyTo(data, writer, options?)

Stringify data to a specific zipson writer

import { stringifyTo, ZipsonStringWriter } from 'zipson';

const writer = new ZipsonStringWriter();
const myData = [1, 2, 3, 4, 5];
stringifyTo(myData, writer, options);
const stringified = writer.value;
parse(string)

Parse a zipson string

import { parse } from 'zipson';

const myStringifiedData = '.......';
const parsed = parse(myStringifiedData);
parseIncremental()

Incrementally parse a zipson string. Call the returned function once for each chunk of the string, calling it with null will signal end of string and returned the parsed result.

import { parseIncremental } from 'zipson';

const increment = parseIncremental();
increment(chunkOfStringifiedData1);
increment(chunkOfStringifiedData2);
increment(chunkOfStringifiedData3);
increment(chunkOfStringifiedData4);
const parsed = increment(null);

Options

Compression options can be provided to the stringify functions. Parse however does not take any options since it is not dependent on knowing with what options the string was compressed.

detectUtcTimestamps

Set to true to tell zipson to detect timestamps within strings such as '2018-01-01T00:00:00Z' in order to represent them more efficiently.

fullPrecisionFloats

By default floating point precision is reduced to 10^-3, set this to true in order to retain full floating point precision.

Writer

Compression output is generalized to a writer class in order to support different output targets. Custom writers have to implement the following API.

abstract class ZipsonWriter {

  // Write a chunk of data
  abstract write(data: string): void;

  // End of writes
  abstract end(): void;
}

Features

  • Efficient compression with a convenient API
  • Zero configuration drop-in replacement for JSON.stringify and JSON.parse
  • Zero dependencies
  • Detection of recurring patterns in recursive structures
  • Automatic reduction of floating point precision unless you actually need those fine 10^-xx decimals
  • Optional detection and compression of UTC timestamps in strings
  • Stream support with the companion lib zipson-stream
  • Support for browser and node

Running the tests

npm test

For running tests in watch mode while developing:

npm run testw

Contributing

Pull requests are welcome. Please see the conventional commits guidelines for commit message formatting.

Versioning

This project is versioned using SemVer See tags and CHANGELOG.md for version details.

License

This project is licensed under the MIT License - see LICENSE.md file for details

FAQs

Package last updated on 16 Feb 2020

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc