Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including jdrop with all npm packages installed. Try it out:

var jdrop = require("jdrop")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

jdrop v0.0.5

Yet another JSON file store. But with some nice features.

jdrop

Seems like everyone who's written a Node app has also written a JSON file storage module. I guess I'm no exception. Here's my rationale for publishing jdrop:

  • It supports updating only a portion of a JSON file without overwriting changes a concurrent user may have made in another portion of the file.
  • Escapes HTML
  • Uses promises instead of callbacks
  • You can choose an error handling option:
    • Catch a rejected promise
    • Let jdrop autocatch errors
    • Provide your own autocatch handler

Usage

const jdrop = require('jdrop')({
        path: 'data',
        autocatch: true
    });

let data = {
    post: {
        body: 'hello'
    }
};

// save data
jdrop.put('posts', data).then(posts => {
    // stuff here runs after data is saved
});

// update part of a file
jdrop.put('posts', 'HI!', 'post.body').then(posts => {
    // stuff here runs after data is saved
});

// get data
jdrop.get('items').then(items => {
    // do stuff with items...
});

// delete part of a file
jdrop.del('items', 'key.example[3].item').then(items => {
    // stuff here runs after the file is altered
});

// delete a file
jdrop.del('items').then(() => {
    // stuff here runs after the file is deleted
});

Settings

When you initialize jdrop, you can pass a config object with two optional settings.

path is the directory in which to store JSON files. The keys you use to access files are paths relative to this directory. The default path is data.

autocatch controlls error handling behavior. The default behavior uses a promise rejection, which you can handle thusly:

jdrop.get('items').then(items => {
    // do stuff...
}).catch(err => {
    console.error(err);
});

If you set autocatch to true, jdrop will no longer reject promises. Instead, it will log the error and end the process with exit code 1.

Alternatively, you can supply a function to the autocatch setting. This function will be passed any error objects that arise. You can use this to send an error to the client without crashing.

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free