Exciting news!Announcing our $4.6M Series Seed. Learn more
Log in


Package Overview
File Explorer

Advanced tools


File system storage and retrieval of objects as JSON


Version published
Yearly downloads
increased by41.6%

Weekly downloads



This Node.js npm module simply serializes JavaScript objects to JSON files into the file system directory of your choosing.

Build Status Dependencies


npm install json-fs-store

Creating a store

The store module is a function that takes a single parameter: the path to the location on the file system where you want to store your objects. If you omit the storage location the 'store' directory in your current working directory will be used.

var store = require('json-fs-store')('/path/to/storage/location');

Adding an object

A stored object must have an id attribute (one will be provided if it does not). The object will be serialized to JSON using JSON.stringify and written to the storage location.

To customize the JSON, you can define the #toJSON function on the object to be stored. That function must return a JavaScript object.

var donkey = { id: '12345', name: 'samuel', color: 'brown' }; store.add(donkey, function(err) { // called when the file has been written // to the /path/to/storage/location/12345.json if (err) throw err; // err if the save failed });

Retrieving an object

To retrieve an object, you must know its id attribute and use it as a parameter for the load() function.

store.load('12345', function(err, object){ if(err) throw err; // err if JSON parsing failed // do something with object here });

Listing stored objects

Every call to the list() function reads the file system and returns the objects stored in the directory you specified when you created your store. Objects will be sorted according to their name attribute, if defined.

store.list(function(err, objects) { // err if there was trouble reading the file system if (err) throw err; // objects is an array of JS objects sorted by name, one per JSON file console.log(objects); });

Removing stored objects

A stored object may be removed simply by passing the object's id attribute to the remove() function. The attribute will be used to remove the object's file from the file system.

store.remove('12345', function(err) { // called after the file has been removed if (err) throw err; // err if the file removal failed });



What is json-fs-store?

File system storage and retrieval of objects as JSON

Is json-fs-store popular?

The npm package json-fs-store receives a total of 150 weekly downloads. As such, json-fs-store popularity was classified as not popular.

Is json-fs-store well maintained?

We found that json-fs-store demonstrated a not healthy version release cadence and project activity. It has 1 open source maintainer collaborating on the project.

Last updated on 21 Sep 2016


Subscribe to our newsletter

Get open source security insights delivered straight into your inbox. Be the first to learn about new features and product updates.

  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc