/PapaParse

Fast and powerful CSV (delimited text) parser that gracefully handles large files and malformed input

Primary LanguageJavaScriptMIT LicenseMIT

Parse CSV with JavaScript

mholt on Gratipay

Papa Parse is the fastest in-browser CSV (or delimited text) parser for JavaScript. It is reliable and correct according to RFC 4180, and it comes with these features:

  • Easy to use
  • Parse CSV files directly (local or over the network)
  • Fast mode (is really fast)
  • Stream large files (even via HTTP)
  • Reverse parsing (converts JSON to CSV)
  • Auto-detect delimiter
  • Worker threads to keep your web page reactive
  • Header row support
  • Pause, resume, abort
  • Can convert numbers and booleans to their types
  • Optional jQuery integration to get files from <input type="file"> elements

Papa Parse has no dependencies - not even jQuery.

Homepage & Demo

To learn how to use Papa Parse:

Papa Parse for Node

Rich Harris forked this project to make Baby Parse which runs in Node.js environments.

$ npm install babyparse

Baby Parse on npm registry

Use it just like Papa Parse. However:

  • Files are not supported; strings only (you can use Node's file facilities to load file contents yourself)
  • Some config options are unavailable:
    • worker
    • download (you can use Node's network facilities to download files yourself)
    • encoding
    • chunk

Otherwise, Baby Parse has nearly all the same functionality as Papa Parse 4.0, including the unparse() utility.

Get Started

Use papaparse.min.js for production.

For usage instructions, see the homepage and, for more detail, the documentation.

Tests

Papa Parse is under test. Download this repository, run npm install, then npm test to run the tests in your browser.

Contributing

To discuss a new feature or ask a question, open an issue. To fix a bug, submit a pull request to be credited with the contributors! Remember, a pull request, with test, is best. You may also discuss on Twitter with #PapaParse or directly to me, @mholt6.