Version 4.1.0

New features:

  • options: accept camelize and underscore forms
  • cast: dont call cast for non column-mappable fields


  • cast: ensure column is a string and not an array
  • stream: handle empty input streams
  • cast: function may return non-string values
  • stream: pass stream options without modification

Version 4.0.1


  • relaxcolumncount: handle records with more columns

Version 4.0.0

This is a complete rewrite based with a Buffer implementation. There are no major breaking changes but it introduces multiple minor breaking changes:

  • options rowDelimiter is now record_delimiter
  • option max_limit_on_data_read is now max_record_size
  • drop the record event
  • normalise error message as {error type}: {error description}
  • state values are now isolated into the info object
  • count is now info.records
  • lines is now info.lines
  • empty_line_count is now info.empty_lines
  • skipped_line_count is now info.invalid_field_length
  • context.count is cast function is now context.records
  • drop support for deprecated options auto_parse and auto_parse_date
  • drop emission of the record event
  • in raw option, the row property is renamed record
  • default value of max_record_size is now 0 (unlimited)
  • remove the record event, use the readable event and instead

New features:

  • new options info, from_line and to_line
  • trim: respect ltrim and rtrim when defined
  • delimiter: may be a Buffer
  • delimiter: handle multiple bytes/characters
  • callback: export info object as third argument
  • cast: catch error in user functions
  • ts: mark info as readonly with required properties
  • comment_lines: count the number of commented lines with no records

API management

  • Multiple tests have been rewritten with easier data sample
  • Source code is now written in ES6 instead of CoffeeScript

Version 3.2.0

  • maxlimitondataread: update error msg
  • src: simplify detection for more data
  • lines: test empty line account for 1 line
  • options: extract default options
  • package: add a few keywords
  • src: precompute escapeIsQuote
  • travis: test agains Node.js 11

Version 3.1.3

  • rowDelimiter: fix overlap with delimiter
  • internal: rename rowDelimiterLength to rowDelimiterMaxLength

Version 3.1.2

  • readme: fix links to project website

Version 3.1.1

  • src: generate code

Version 3.1.0

  • package: move to
  • samples: new cast sample
  • package: upgrade to babel 7
  • samples: new mixed api samples
  • samples: new column script
  • samples: update syntax
  • package: improve ignore files

Version 3.0.0

Breaking changes:

  • columns: skip empty values when null, false or undefined


  • sync: refactor internal variables
  • index: use destructuring assignment for deps

Version 2.5.0

  • typescript: make definition header more relevant

Version 2.4.1

  • to: ignore future records when to is reached

Version 2.4.0

  • trim: after and before quote
  • tests: compatibility with Node.js 10
  • trim: handle quote followed by escape
  • parser: set nextChar to null instead of empty
  • travis: run against node 8 and 10

Version 2.3.0

  • cast: pass the header property
  • auto_parse: deprecated message on tests
  • cast: inject lines property

Version 2.2.0

  • cast: deprecate auto_parse
  • auto_parse: function get context as second argument

Version 2.1.0

  • skiplineswith_error: DRYed implementation
  • skiplineswith_error: Go process the next line on error
  • events: register and write not blocking
  • test: prefix names by group membership
  • events: emit record
  • raw: test to ensure it preserve columns
  • package: latest dependencies (28 march 2018)
  • raw: ensure tests call and success
  • package: ignore npm and yarn lock files
  • sync: handle errors on last line

Version 2.0.4

  • package: move babel to dev dependencies

Version 2.0.3

  • package: es5 backward compatiblity
  • package: ignore yarn lock file

Version 2.0.2

  • package: only remove js files in lib
  • source: remove unreferenced variables #179
  • package: start running tests in preversion
  • package: new release workflow


This major version use CoffeeScript 2 which produces a modern JavaScript syntax (ES6, or ES2015 and later) and break the compatibility with versions of Node.js lower than 7.6 as well as the browsers. It is however stable in term of API.

  • package: use CoffeeScript 2


  • package: revert to CoffeeScript 1


Irrelevant release, forgot to generate the coffee files.


  • package: preserve compatibility with Node.js < 7.6


  • options: auto_parse as a user function
  • options: autoparsedate as a user function
  • test: should require handled by mocha
  • package: coffeescript 2 and use semver tilde
  • options: ensure objectMode is cloned


  • relaxcolumncount: honors count while preserving skippedlinecount
  • api: improve argument validation


  • sync: catch err on write


  • relax: handle double quote


  • src: group state variable initialisation
  • package: update repo url
  • quote: disabled when null, false or empty
  • src: remove try/catch
  • src: optimize estimation for row delimiter length
  • lines: improve tests
  • src: use in instead of multiple is
  • src: string optimization


  • skip default row delimiters when quoted #58
  • auto_parse: cleaner implementation
  • src: isolate internal variables


  • options: new to and from options


  • rowDelimiters: fix all last month issues


  • regression with trim and last empty field #123


  • rowDelimiter: simplification
  • fix regression when trim and skipemptylines activated #122
  • auto_parse = simplify internal function


  • src: trailing whitespace and empty headers #120
  • rowDelimiter: adding support for multiple row delimiters #119
  • Remove unnecessary argument: Parser.prototype.__write #114


  • skiplineswithemptyvalues: support space and tabs #108
  • test: remove coverage support
  • test: group by api, options and properties
  • skiplineswithemptyvalues option
  • write test illustrating column function throwing an error #98
  • added ability to skip columns #50


  • reduce substr usage
  • new raw option


  • emptylinecount counter and renamed skipped to skippedlinecount
  • skipped line count


  • avoid deoptimization due to wrong charAt index #103
  • parser writing before assigning listeners


  • column: stop on column count error #100


  • make the parser more sensitive to input
  • test case about the chunks of multiple chars without quotes
  • test about data emission with newline


  • stream: call end if data instance of buffer
  • travis: add nodejs 6
  • columns: fix line error #97


  • relaxcolumncount: default to false (strict)


  • relaxcolumncount: backward compatibility for 1.0.x
  • relaxcolumncount: introduce new option
  • columns: detect column length and fix lines count


  • fix quotes tests that used data with inconsistent number of #73
  • add tests for inconsistent number of columns #73
  • throw an error when a column is missing #73
  • travis: test nodejs versions 4, 5
  • maxlimitondataread: new option
  • removing the duplicate files in test and samples #86
  • option argument to accept the number of bytes can be read #86
  • avoid unwanted parsing when there is wrong delimiter or row delimiter #86


  • sync: support objname


  • sync: please older versions of node.js
  • sync: new sample


  • sync: new module
  • removed global variable record on stream.js example #70


  • api: accept buffer with 3 arguments #57
  • package: latest dependencies
  • spectrum: bypass regression test


  • autoparse: work on all fields, rename to β€œis*”
  • auto_parse: simplify test