jsonwatch

Json file reader, which will emit events on the Json file content. It will also watch your Json file for any changes and emit events which will tell you about the changes. This module was intended for reading/watching configuration files which may change while running an app.

Getting started

First, install from npm by running npm i jsonwatch, or add "jsonwatch": "1.1.x" to your dependencies in your package.json.

Then require() jsonwatch and load your Json file

var JsonWatch = require('jsonwatch');
var config = new JsonWatch('./config.json');

Now, you should add listeners for your Json structure.

Methods

.on(event, fn)

Register an event handler fn.

.once(event, fn)

Register a single-shot event handler fn, removed immediately after it is invoked the first time.

.off(event, fn)

Remove event handler fn, or pass only the event name to remove all handlers for event.

.listeners(event)

Return an array of callbacks, or an empty array.

.hasListeners(event)

Check if this emitter has event handlers.

Events

add event

Something was added to the Json.

Event arguments:

1. The path to what was added.
2. The value that was added.
3. If the added value is an object, argument 2 will always be {}, since more events will follow, adding the recursive content. However, if you want the full recusive object tree immediately, you can get that from this third argument. If the added value is not an object, this third argument will be identical with the second.

cng event

Something in the Json was changed.

Event arguments:

1. The path to what was changed.
2. The value that was before the change.
3. The value after the change.

err event

There was an error.

Event arguments:

1. An Error.

rm event

Something was removed from the Json.

Event arguments:

1. The path of what was removed.
2. The value that was removed.

Paths in the Json

{
 "users": {
   "alfred": {
     "password": "qwerty"
   },
   "olof": {
     "password": "123456",
     "aliases": [ "olle", "lol", "floflo" ]
   }
 }
}

When loading the Json above, those events will be emitted:

1. add, with arguments: 1. "/users" and 2. {}
2. add, with arguments: 1. "/users/alfred" and 2. {}
3. add, with arguments: 1, "/users/alfred/password" and 2. `"qwerty"``
4. add, with arguments: 1. "/users/olof" and 2. {}
5. add, with arguments: 1, "/users/olof/password" and 2. `"123456"``
6. add, with arguments: 1. "/users/olof/aliases" and 2. [ "olle, "lol", "floflo" ]

So, the paths are made from Json object keys. Any other type in a Json will become the "value".

Changelog

1.1.0

• Added the third argument to add event callbacks, which will give you the full recursive object tree, if the added value is an object.

1.0.0

First version!