The csv project provides CSV generation, parsing, transformation and serialization for Node.js.
It has been tested and used by a large community over the years and should be considered reliable. It provides every option you would expect from an advanced CSV parser and stringifier.
This package exposes 4 packages:
csv-generate
(GitHub),
a flexible generator of CSV string and Javascript objects.
csv-parse
(GitHub),
a parser converting CSV text into arrays or objects.
csv-stringify
(),
a stringifier converting records into a CSV text.
Documentation
The full documentation for the current version is available here.
Usage
Installation command is npm install csv.
Each package is fully compatible with the Node.js stream 2 and 3 specifications. Also, a simple callback-based API is always provided for convenience.
Synchronous sample
// Import the packageimport * as csv from "csv/sync";// Run the pipelineimport { generate, parse, transform, stringify } from "csv/sync";// Run the pipelineconst input = generate({ seed: 1, columns: 2, length: 2 });const rawRecords = parse(input);const refinedRecords = transform(rawRecords, (data) => data.map((value) => value.toUpperCase()),);const output = stringify(refinedRecords);// Print the final resultconsole.log
Streaming sample
This example uses the Stream API to create a processing pipeline.
// Import the packageimport * as csv from "csv";// Run the pipelinecsv // Generate 20 records .generate({ delimiter: "|", length: 20, }) // Transform CSV data into records .pipe( csv.parse({ delimiter: "|", }), ) // Transform each value into uppercase .pipe( csv.transform((record) => { return record.map((value) => { return
Development
This parent project doesn't have tests itself but instead delegates the tests to its child projects.
Read the documentation of the child projects for additional information.
Contributors
The project is sponsored by Adaltas, an Big Data consulting firm based in Paris, France.