A simple, browser compatible, incremental CSV parser.
npm install incremental-csv-parserA fast & lightweight CSV parser with an incremental parsing api. No
dependencies; browser compatible. Includes ESM and CJS builds. All column
values are strings (numbers and dates will not automatically be parsed).
Fully compatible with rfc4180.
``js
import { parse } from 'incremental-csv-parser';
const results = await parse(a,b,c,d
1,2,3,4
5,6,7,8);
console.log(results);
// [
// { a: '1', b: '2', c: '3', d: '4' },
// { a: '5', b: '6', c: '7', d: '8' },
// ]
`
`js
import { CSVParser } from 'incremental-csv-parser';
const results = [];
const parser = new CSVParser((row) => {
results.push(row);
});
parser.process('a,b,c,d\n');
parser.process('1,2,3,4\n');
console.log(results.shift()); // { a: '1', b: '2', c: '3', d: '4' }
parser.process('5,6,7,8');
parser.flush();
console.log(results.shift()); // { a: '5', b: '6', c: '7', d: '8' }
`
If column names are known ahead of time, they can be passed in via generics.
`ts
import { CSVParser } from 'incremental-csv-parser';
type ColumnName = 'a' | 'b' | 'c' | 'd';
const results: Array
const parser = new CSVParser
results.push(row);
});
`
Both the parse function and CSVParser class have an optional second argument
for explicitly providing column names for a csv.
`ts
import { CSVParser } from 'incremental-csv-parser';
const columns = ['a', 'b', 'c', 'd'];
const results = parse(1,2,3,4
5,6,7,8, columns);
console.log(results);
// [
// { a: '1', b: '2', c: '3', d: '4' },
// { a: '5', b: '6', c: '7', d: '8' },
// ]
``