https://github.com/matteofigus/nice-json2csv

A node.js tool for converting json to csv
https://github.com/matteofigus/nice-json2csv

Last synced: about 2 months ago
JSON representation

A node.js tool for converting json to csv

• Host: GitHub
• URL: https://github.com/matteofigus/nice-json2csv
• Owner: matteofigus
• License: mit
• Created: 2013-06-03T11:38:23.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2018-06-01T19:40:52.000Z (over 6 years ago)
• Last Synced: 2024-11-01T06:51:38.433Z (about 2 months ago)
• Language: JavaScript
• Homepage:
• Size: 41 KB
• Stars: 39
• Watchers: 4
• Forks: 10
• Open Issues: 11
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
nice-json2csv [![Build Status](https://secure.travis-ci.org/matteofigus/nice-json2csv.png?branch=master)](http://travis-ci.org/matteofigus/nice-json2csv)

=============

[![Greenkeeper badge](https://badges.greenkeeper.io/matteofigus/nice-json2csv.svg)](https://greenkeeper.io/)

[![NPM](https://nodei.co/npm/nice-json2csv.png?downloads=true)](https://npmjs.org/package/nice-json2csv)

A simple node.js tool that converts a Json object to a CSV output without requiring headers.

It can extend the Response object on Express.js to easily produce csv files available to be downloaded.

# Installation

```shell

npm install nice-json2csv

```

# Usage

### convert(jsonObject [, columns] [, suppressHeader])

Include the library and use the convert function to get a csv string from your json object.

```js

var json2csv = require('nice-json2csv');

var myData = [{ "first_name": "John", "last_name": "Doe"}, { "first_name": "Jane", "last_name": "Doe"}, { "first_name": "Mick"}];

// all the json object

var csvContent = json2csv.convert(myData);

// just the 'first_name' column

var justFirstNames = json2csv.convert(myData, ["first_name"]);

// without the header row

var noHeader = json2csv.convert(myData, ["first_name"], true);

```

# Usage with Express.js

Include the library and decorate the Express object with app.use() as shown in the example after the express() initialisation. After that, res.csv() will be available.

### res.csv(jsonObject, fileName [, columns] [, suppressHeader])

Somewhere in your app.js, your middleware, or wherever you instantiate express.js

```js

var express = require('express');

var json2csv = require('nice-json2csv');

var app = express();

app.use(json2csv.expressDecorator);  

app.get('/getCsv', function(req, res){

	res.csv([{ "hello": "world" }], "myFile.csv");

});

app.listen(3000);

```

# License

MIT

[![Bitdeli Badge](https://d2weczhvl823v0.cloudfront.net/matteofigus/nice-json2csv/trend.png)](https://bitdeli.com/free "Bitdeli Badge")