CSVEventEmitter

CSVEventEmitter is a synchronous CSV parser implemented as an event emitter.

const {CSVEventEmitter} = require ('csv-events')

const ee = new CSVEventEmitter ({
   mask: 0b101 // only 1st and 3rd column will be signaled
// delimiter: ',',
// empty: null,
// maxLength: 1e6,
})

const names = []; ee.on ('c', () => {
  if (ee.row !== 0n && ee.column === 1) names.push (ee.value)
})

ee.write ('ID,NAME\r\n')
ee.write ('1,admin\n')
ee.end ('2,user\n') // `names` will be ['admin', 'user']

Incoming data in form of Strings are supplied via the write and end synchronous methods (this API is loosely based on StringDecoder's one) producing a sequence of c ("cell") and r ("row") events.

No event carries any payload, though the parsed content details such as

• row, column numbers;
• unquoted cell content

are available via the CSVEventEmitter instance properties. This approach lets the application read selected portions of incoming text avoiding some overhead related to data not in use.

Installation

npm install csv-events

Constructor Options

Name	Default value	Description
mask		Bit mask of required fields
delimiter	','	Column delimiter
empty	null	The value corresponding to zero length cell content
maxLength	1e6	The maximum buf.length allowed (inherently, the maximum length of write and end arguments)

Methods

Name	Description
write (s)	Append s to the internal buffer buf and emit all events for its parseable part; leave last unterminated cell source in buf
end (s)	Execute write (s) and emit last events for the rest of buf and, finally, emits 'end'

Events

|Name|Payload|Description| |-|-| |c|column| Emitted for each cell which number satisfies mask when its content is available (via value and raw properties, see below)| |r| | Emitted for each row completed| |end| | Emitted by end (s)|

Properties

Name	Type	Description
unit	Number or Bigint	1 corresponding to mask by type
row	BigInt	Number of the current row: 0n for the CSV header, if present
column	Number	Number of the current column, 0 based
index	Number or Bigint	Single bit mask corresponding to column (2**column)
buf	String	The internal buffer containing unparsed portion of the text gathered from write arguments
from	Number	Starting position of the current cell in buf
to	Number	Ending position of the current cell in buf
raw	String	Verbatim copy of buf between from and to, except row delimiters (computed property)
value	String	Unquoted raw, replaced with empty for a zero length string (computed property)

Limitations

Line Breaks

CSVEventEmitter always recognizes both:

• CRLF ('\r\n', RFC 4180, Windows style) and
• LF ('\n', UNIX style) as line breaks without explicit option setting.

There is no way to apply CSVEventEmitter directly to texts generated with MacOS pre-X, Commodore, Amiga etc. neither any plans to implement such compatibility features.

CSV Validity

CSVEventEmitter doesn't make any attempt to restore data from broken CSV source. So, a single unbalanced double quote will make all the rest of file lost.

The best CSVEventEmitter can do in such case is not to waste too much memory keeping its internal buffer not bigger than maxLength characters.