npmpackage.info

Gathering detailed insights and metrics for json-csv

Other packages similar to json-csv

csv-parser

3.2.0

Streaming CSV parser that aims for maximum speed as well as compatibility with the csv-spectrum test suite

json-2-csv

5.5.9

A JSON to CSV and CSV to JSON converter that natively supports sub-documents and auto-generates the CSV heading.

vue-json-excel

0.3.0

Download your JSON as an excel or CSV file directly from the browser

csvtojson

2.0.10

A tool concentrating on converting csv data to JSON with customised parser supporting

Gathering detailed insights and metrics for json-csv

json-csv - 4.0.21 | npmpackage.info

json-csv

Simple CSV export module that can export a rich JSON array of objects to CSV.

4.0.21

BSD-3-Clause

JavaScript

12.16 kB

4.2

Installations

npm install json-csv

Developer Guide

BETA

Typescript

No

Module System

CommonJS

Min. Node Version

>=10

Node Version

10.24.1

NPM Version

6.14.12 Score

80.7

Supply Chain

100

Quality

86.7

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

0

Total

59

Closed

9

Merged

50

Issues

Open

0

Total

15

Closed

15

Releases

Unable to fetch releases

Languages

JavaScript

TypeScript

JavaScript (76.62%)

TypeScript (23.38%)

Developer

IWSLLC

Download Statistics

Total Downloads

Last Day

Last Week

Last Month

Last Year

GitHub Statistics

BSD-3-Clause License

16 Stars

188 Commits

17 Forks

2 Watchers

2 Branches

7 Contributors

Updated on Jul 02, 2025

Maintainers

View All 7 Contributors

Package Meta Information

Latest Version

4.0.21

Package Id

json-csv@4.0.21

Unpacked Size

12.16 kB

Size

4.96 kB

File Count

NPM Version

6.14.12

Node Version

10.24.1

Published on

Jul 02, 2025

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

NaN

Compared to previous day

Last Week

NaN

Compared to previous week

Last Month

NaN

Compared to previous month

Last Year

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dev Dependencies

@iwsio/eslint-config coffeescript debug mocha should typescript

json-csv

This is a Node.JS package that can transorm data to CSV. I originally built this back in the 2014 (in the Node v0.10 days). We've come a long way, and it still works! So I won't be deprecating this until it can no longer function in active LTS versions of Node.JS. As LTS versions of Node.JS release, I'll keep this test pipeline up to date.

However, this version of the package (json-csv), 4.x is in maintenance mode and will only receive critical updates and occasionally tooling updates. For more recent improvements like ESM, Typescript support, etc, please refer to @iwsio/json-csv-node for the latest, active version of this package. It shares an identical API with this one and should be pretty seamless to replace.

If you need just a buffered CSV that works in browser apps, checkout the core project @iwsio/json-csv-core. It supports everything except Node Stream API.

@iwsio/json-csv-node v6 - June 2023

The latest version 6 just released in June 2023 and includes better type definitions along with ESM & CommonJS support. Read more about it on the v6 blog post.

Usage

Buffered

1const jsoncsv = require('json-csv')
2
3const csv = await jsoncsv.buffered(data, options) //returns Promise
4
5//optionally, you can use the callback
6jsoncsv.buffered(data, options, (err, csv) => {...}))

data: Array of JS objects
options: {fields: [], ...}
optional callback: returns string result

Streaming

When using the streaming API, you can pipe data to it in object mode.

1const jsoncsv = require('json-csv')
2
3const readable = some_readable_source //<readable source in object mode>
4readable
5  .pipe(jsoncsv.stream(options)) //transforms to Utf8 string and emits lines
6  .pipe(something_else_writable)
7})

Options

1{
2  //field definitions for CSV export
3  fields :
4  [
5    {
6      //required: field name for source value
7      name: 'string',
8
9      //required: column label for CSV header
10      label: 'string',
11
12      //optional: transform value before exporting
13      transform: function(value) { return value; }
14    }
15  ],
16
17  // Other default options:
18  fieldSeparator: ","
19  ,ignoreHeader: false
20  ,encoding: "utf8"
21}

Advanced Example

Here, you can see we're using a deeper set of objects for our source data and we're using dot notation in the field definitions.

1const items = [
2  {
3    downloaded: false,
4    contact: {
5      company: 'Widgets, LLC',
6      name: 'John Doe',
7      email: 'john@widgets.somewhere',
8    },
9    registration: {
10      year: 2013,
11      level: 3,
12    },
13  },
14  {
15    downloaded: true,
16    contact: {
17      company: 'Sprockets, LLC',
18      name: 'Jane Doe',
19      email: 'jane@sprockets.somewhere',
20    },
21    registration: {
22      year: 2013,
23      level: 2,
24    },
25  },
26]
27const options = {
28  fields: [
29    {
30      name: 'contact.company', // uses dot notation
31      label: 'Company',
32    },
33    {
34      name: 'contact.name',
35      label: 'Name',
36    },
37    {
38      name: 'contact.email',
39      label: 'Email',
40    },
41    {
42      name: 'downloaded',
43      label: "Downloaded",
44      transform: (v) => v ? 'downloaded' : 'pending',
45    },
46    {
47      name: 'registration.year',
48      label: 'Year',
49    },
50    {
51      name: 'registration.level',
52      label: 'Level',
53      transform: (v) => {
54        switch (v) {
55          case 1: return 'Test 1'
56          case 2: return 'Test 2'
57          default: return 'Unknown'
58        }
59      },
60    },
61  ],
62}
63
64async function writeCsv() {
65  try {
66    let result = await csv.buffered(items, options)
67    console.log(result)
68  } catch (err) {
69    console.error(err)
70  }
71}
72
73writeCsv()

Output

Company,Name,Email,Downloaded,Year,Level
"Widgets, LLC",John Doe,john@widgets.somewhere,pending,2013,Unknown
"Sprockets, LLC",Jane Doe,jane@sprockets.somewhere,downloaded,2013,Test 2

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

9

Maintained

Determines if the project is "actively maintained".

8

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

3

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

2

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

Reason

dependency not pinned by hash detected -- score normalized to 2

Details

Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/core-test.yaml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/iwsllc/json-csv/core-test.yaml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/core-test.yaml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/iwsllc/json-csv/core-test.yaml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/core-test.yaml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/iwsllc/json-csv/core-test.yaml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/node-test.yaml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/iwsllc/json-csv/node-test.yaml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/node-test.yaml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/iwsllc/json-csv/node-test.yaml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/node-test.yaml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/iwsllc/json-csv/node-test.yaml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/node-test.yaml:38: update your workflow using https://app.stepsecurity.io/secureworkflow/iwsllc/json-csv/node-test.yaml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/node-test.yaml:42: update your workflow using https://app.stepsecurity.io/secureworkflow/iwsllc/json-csv/node-test.yaml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/node-test.yaml:49: update your workflow using https://app.stepsecurity.io/secureworkflow/iwsllc/json-csv/node-test.yaml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/push-core.yml:18: update your workflow using https://app.stepsecurity.io/secureworkflow/iwsllc/json-csv/push-core.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/push-core.yml:34: update your workflow using https://app.stepsecurity.io/secureworkflow/iwsllc/json-csv/push-core.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/push-node.yml:18: update your workflow using https://app.stepsecurity.io/secureworkflow/iwsllc/json-csv/push-node.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/push-node.yml:34: update your workflow using https://app.stepsecurity.io/secureworkflow/iwsllc/json-csv/push-node.yml/main?enable=pin
Warn: npmCommand not pinned by hash: .github/workflows/core-test.yaml:29
Warn: npmCommand not pinned by hash: .github/workflows/node-test.yaml:32
Warn: npmCommand not pinned by hash: .github/workflows/node-test.yaml:54
Info: 0 out of 9 GitHub-owned GitHubAction dependencies pinned
Info: 0 out of 4 third-party GitHubAction dependencies pinned
Info: 3 out of 6 npmCommand dependencies pinned

0

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

License

Determines if the project has defined a license.

0

SAST

Determines if the project uses static code analysis.

Score

4.2

/10

Last Scanned on 2025-07-14

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More