# json2csvn

**Repository Path**: zyjsuper/json2csvn

## Basic Information

- **Project Name**: json2csvn
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-28
- **Last Updated**: 2025-11-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# json2csv

[![npm version](https://badge.fury.io/js/@json2csv%2Fplainjs.svg)](https://badge.fury.io/js/@json2csv%2Fplainjs)
[![Node.js CI](https://github.com/juanjoDiaz/json2csv/actions/workflows/on-push.yaml/badge.svg)](https://github.com/juanjoDiaz/json2csv/actions/workflows/on-push.yaml)
[![Coverage Status](https://coveralls.io/repos/github/juanjoDiaz/json2csv/badge.svg?branch=main)](https://coveralls.io/github/juanjoDiaz/json2csv?branch=main)
[![license](https://img.shields.io/npm/l/serverless-plugin-warmup.svg)](https://raw.githubusercontent.com/juanjoDiaz/json2csv/main/LICENSE.md)

Fast and highly configurable JSON to CSV converter.

## Features

- Fast and lightweight
- Support for standard JSON as well as NDJSON
- Scalable to infinitely large datasets (using stream processing)
- Advanced data selection (automatic field discovery, underscore-like selectors, custom data getters, default values for missing fields, ...)
- Support for custom input data transformation
- Support for custom csv cell formatting.
- Highly customizable (supporting custom quotation marks, delimiters, eol values, etc.)
- Automatic escaping (preserving new lines, quotes, etc.)
- Optional headers
- Unicode encoding support
- Pretty printing in table format to stdout


## json2csv ecosystem

There are multiple flavours of json2csv:

* The **[Plainjs](https://www.npmjs.com/package/@json2csv/plainjs)** package includes:
  * **[Parser](packages/plainjs/README.md#parser):** Pure Javascript synchronous parser. High-performant and runs both node.js and the browser. It´s the fastest but loads both the JSON and the resulting CSV in memory, and block the event loop while processing. Not recommended unless the JSON data is small.
  * **[Stream Parser](packages/plainjs/README.md#stream-parser):** Pure Javascript stream parser. High-performant and runs both node.js and the browser. It keeps a consistent memory footprint and doesn't block the event loop. It's the base of all other parsers. Recommended to build your own parser.
* The **[Node](https://www.npmjs.com/package/@json2csv/node)** packages includes:
  * **[Node Transform](packages/node/README.md#node-transform):** Wraps the `Stream Parser` in a Node.js Transform Stream. Recommended for Node.js users using stream.
  * **[Node Async Parser](packages/node/README.md#node-async-parser):** Wraps the `Node Transform` to offer a friendly promise-based API similar to the synchronous `Parser`. Recommended for Node.js users that want a higher abstraction level.
* The **[WHATWG](https://www.npmjs.com/package/@json2csv/whatwg)** package includes:
  * **[WHATWG Transform Stream](packages/whatwg/README.md#whatwg-transform-stream):** Wraps the `Stream Parser` in a WHATWG Transform Stream. Recommended for browser users using web streams.
  * **[WHATWG Async Parser](packages/whatwg/README.md#whatwg-async-parser):** Wraps the `WHATWG Transform Stream` to offer a friendly promise-based API similar to the synchronous `Parser`. Recommended for browser users that want a higher abstraction level.
* The **[CLI](https://www.npmjs.com/package/@json2csv/cli)** package includes:
	* **[CLI](packages/cli/README.md):** Makes the node.js interfaces accesible through the command line. Recommended from CLI (sh/bash/zsh/...) users and CLI scripts.

And a couple of libraries that enable additional configurations:

* The **[Transforms](https://www.npmjs.com/package/@json2csv/transforms)** package includes the built-in `transforms` for json2csv (unwind and flatten) allowing the using to transform data before is parsed (See [docs](https://juanjodiaz.github.io/json2csv/#/advanced-options/transforms)).
* The **[Formatters](https://www.npmjs.com/package/@json2csv/formatters)** package includes the built-in `formatters` for json2csv (one for each data type, an excel-specific one, etc.). Formatters convert JSON data types into CSV-compatible strings (See [docs](https://juanjodiaz.github.io/json2csv/#/advanced-options/formatters)).

## Documentation

See [https://juanjodiaz.github.io/json2csv](https://juanjodiaz.github.io/json2csv).

## License

See [LICENSE.md](https://github.com/juanjoDiaz/json2csv/blob/main/LICENSE.md).