# node-csv

> A CSV parser for node.js

Latest version **0.1.2** (published 2011-09-19) · 0 weekly downloads

## Install

```sh
npm install node-csv
pnpm add node-csv
yarn add node-csv
bun add node-csv
```

## Health

**Score 10/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; low quality score; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.1.2 |
| Published | 2011-09-19 |
| First published | 2011-09-19 |
| Weekly downloads | 0 |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=0.2.2 |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Chris O'Hara |
| Maintainers | cohara87 |
| Keywords | csv, parse, csv parser, csv parsing |

## Links

- npm: https://www.npmjs.com/package/node-csv
- npm.io page: https://npm.io/package/node-csv

## Alternatives

- [@sapphire/ratelimits](https://npm.io/package/@sapphire/ratelimits.md) — 4.4K weekly downloads
- [js-csvparser](https://npm.io/package/js-csvparser.md) — 2.0K weekly downloads
- [@adadapted/js-sdk](https://npm.io/package/@adadapted/js-sdk.md) — 251 weekly downloads
- [@grapecity/spread-sheets-sparklines](https://npm.io/package/@grapecity/spread-sheets-sparklines.md) — 103 weekly downloads
- [@1selfworld/adchain-sdk-react-native](https://npm.io/package/@1selfworld/adchain-sdk-react-native.md) — 80 weekly downloads

## Recent versions

- 0.1.2 (latest) — 2011-09-19
- 0.1.0 — 2011-09-19
- 0.1.1 — 2011-09-19

## README

A CSV parser for node.js

To install node-csv, use [npm](http://github.com/isaacs/npm):

    $ npm install node-csv

## Usage

    var csv = require('node-csv').createParser();
    
    var csv_str = "1,2,3\n4,5,6";
    
    csv.parse(csv_str, function(err, data) {
    
        console.log(data); //Outputs: [[1,2,3],[4,5,6]]
        
    });
    
    // or
    
    csv.parseFile('./test.csv', function(err, data) {
        console.log(data);
    });

createParser() takes 3 optional params - delimiter, quote_char, quote_escape

E.g. to parse tab separated values where fields are wrapped with quotes (") and quotes are escaped with \"

    var csv = require('node-csv').createParser('\t', '"', '\\');
    
node-csv can also convert each row to an object based on the column names in the first row, e.g.

test.csv

    id,user,pass
    1,foo,bar
    
parse.js

    var csv = require('node-csv').createParser();
    
    csv.mapFile('./test.csv', function(err, data) {
    
        console.log(data); //Outputs: [ { id: '1', user: 'foo', pass: 'bar' } ]
        
    });

---
_Source: https://npm.io/package/node-csv · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._