Skip to content
Yet another JSON file store. But with some nice features.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


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


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


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 => {

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.

You can’t perform that action at this time.