/PapaParse

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 (formerly the jQuery Parse Plugin) is a robust and powerful CSV (character-separated values) parser with these features:

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

Papa Parse has no dependencies - not even jQuery.

Homepage & Demo

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 3.0, including the unparse() function.

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 and open tests/tests.html in your browser to run them.

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.

Origins

Papa Parse is the result of a successful experiment by SmartyStreets which matured into an independent, fully-featured Javascript library.