Nestable Processes Mutate

    jquery-csv

    1.0.21 • Public • Published

    ✓ NOTICE: For a more modern CSV parser, check out the @VanillaES/CSV project ✓

    GitHub Releases NPM Release Bundlephobia Latest Status Release Status

    Introduction

    jQuery-csv is an artifact of a simpler time (ie 2012) when the JS library ecosystem was still very underdeveloped. This was the first and still is one of the fastest spec compliant CSV parsers available.

    This is a complete, customizable, battle tested, performance optimized CSV parser that follows the traditional jQuery-style of syntax. Featuring a slim Chomsky - Type III parser implementation. Full (that means 100%) IETF RFC 4180 compliance. Including coverage for a few edge cases that even the spec fails to cover.

    Enough with the wind-up...

    Features

    • Convert a CSV String to an array
    • Convert a multi-line CSV string to a 2D array
    • Convert a multi-line CSV string to an array of objects (ie header:value pairs)
    • Convert an array of values to CSV (under development)
    • Convert an array of objects to CSV (under development)
    • Hooks/Callbacks to extend the default parsing process
    • Customizable delimiter (default: ") and separator (default: ,) characters
    • Node.js support (ie CommonJS importing and async callback support)

    Syntax

    Importing

    Client-Side (ie browser) - import via the script element.

    <script src="jquery-csv.js"></script>

    Server-Side (ie Node.js) - Import via the standard CommonJS approach.

    Install the package via NPM

    npm i jquery-csv

    Then import it as a CommonJS module.

    var csv = require('jquery-csv');

    Usage

    Each one of the methods can be called with the following form:

    $.csv.function(csv, {options}, callback);
    Name Description
    csv required The csv data to be transformed.
    options optional An object containing user-defined overrides for the default options.
    callback optional Used for Node.js-style async callbacks. Uses the form function(err, data).

    Methods

    toArray

    Parse a single entry string to an array

    $.csv.toArray(csv);

    Documented under API#$.csv.toArray().

    toArrays

    Parse a multi-line CSV string to a 2D array

    $.csv.toArrays(csv);

    Documented under API#$.csv.toArrays().

    toObjects

    Parse a multi-line CSV string to an array of objects

    $.csv.toObjects(csv);

    Documented under API#$.csv.toObjects().

    fromArrays

    Convert array data to a CSV string

    $.csv.fromArrays(arrays);

    fromObjects

    Convert an array of objects to a CSV string

    $.csv.fromObjects(objects);

    Documentation

    Use Cases

    Instead of the typical useless contrived example code, I have provided a handful of simple yet powerful demos. Not only are they fun to play with but a quick peak at the source will show you how simple and easy they were to implement. Feel free to copy and reuse these in your own projects.

    Basic Usage

    Want to play with the parser and maybe validate your CSV data without all the frills? No need to download the source first, there's a demo for that...

    jQuery-CSV - toArray()

    jQuery-CSV - toArrays()

    jQuery-CSV - fromArrays()

    jQuery-CSV - toObjects()

    jQuery-CSV - fromObjects()

    Node.js ESM (EcmaScript Module) Import

    Here's how to import jQuery-CSV as am ECMAScript module Node.js:

    jQuery-CSV - ESM Import Demonstration

    Node.js CJS (CommonJS Module) Import

    Here's how to import jQuery-CSV as CommonJS module Node.js:

    jQuery-CSV - CJS Import Demonstration

    Client-Side File Handling

    Yes, you read that right. It's now possible to open local files in the browser without firing a single request to the server.

    The functionality is still pretty new so not all browsers support it (I'm looking @ you IE). If that's not an issue I highly suggest you try it. It's much easier than the traditional client/server approach.

    jQuery-CSV - File Handling Demonstration

    jQuery-CSV + Flot

    Hands down, the most exciting addition to the demo collection so far...

    You can input the data set using either the text area provided or via uploading CSV data files.

    Want to plot 5 data sets on the same grid, no problem; Just upload 5 files containing one dataset each. The jQuery-CSV will handle the plumbing while Flot will make it all look pretty.

    jQuery-CSV - Flot Demonstration

    jQuery-CSV + Google Visualization API

    OK, I lied. This one is even cooler than Flot. Hike up your fancy pants because these things look slick.

    Don't want to draw a line graph, no problem you can tap into the massive collection of different graph types available. Embedded is a fully configurable dashboard.

    Warning: You may experience multiple spontaneous 'oh my got that's soo awesome' fits of excitement. Maybe even get stoked. Happens to the best us...

    jQuery-CSV - Google Visualization API Demonstration

    jQuery-CSV coding style is inherited from the JQuery Core Style Guidelines

    Keywords

    none

    Install

    npm i jquery-csv

    DownloadsWeekly Downloads

    4,263

    Version

    1.0.21

    License

    MIT

    Unpacked Size

    51.8 kB

    Total Files

    5

    Last publish

    Collaborators

    • evanplaice