@redis/json

This package provides support for the RedisJSON module, which adds JSON as a native data type to Redis.

Should be used with redis/@redis/client.

:warning: To use these extra commands, your Redis server must have the RedisJSON module installed.

Usage

For a complete example, see managing-json.js in the examples folder.

Storing JSON Documents in Redis

The JSON.SET command stores a JSON value at a given JSON Path in a Redis key.

Here, we'll store a JSON document in the root of the Redis key "mydoc":

await client.json.set('noderedis:jsondata', '$', {
  name: 'Roberta McDonald',
  pets: [{
    name: 'Rex',
    species: 'dog',
    age: 3,
    isMammal: true
  }, {
    name: 'Goldie',
    species: 'fish',
    age: 2,
    isMammal: false
  }]
});

For more information about RedisJSON's path syntax, check out the documentation.

Retrieving JSON Documents from Redis

With RedisJSON, we can retrieve all or part(s) of a JSON document using the JSON.GET command and one or more JSON Paths. Let's get the name and age of one of the pets:

const results = await client.json.get('noderedis:jsondata', {
  path: [
    '.pets[1].name',
    '.pets[1].age'
  ]
});

results will contain the following:

 { '.pets[1].name': 'Goldie', '.pets[1].age': 2 }

Performing Atomic Updates on JSON Documents Stored in Redis

RedisJSON includes commands that can atomically update values in a JSON document, in place in Redis without having to first retrieve the entire document.

Using the JSON.NUMINCRBY command, we can update the age of one of the pets like this:

await client.json.numIncrBy('noderedis:jsondata', '.pets[1].age', 1);

And we can add a new object to the pets array with the JSON.ARRAPPEND command:

await client.json.arrAppend('noderedis:jsondata', '.pets', {
  name: 'Robin',
  species: 'bird',
  age: 1,
  isMammal: false
});

Current Tags

5.9.0-beta.3 ... beta (6 months ago)
5.11.0 ... latest (2 months ago)
5.0.0-next.7 ... next (a year ago)

30 Versions

5.11.0 ... 2 months ago
5.10.0 ... 5 months ago
5.9.0 ... 6 months ago
5.9.0-beta.3 ... 6 months ago
5.8.3 ... 6 months ago
5.9.0-beta.2 ... 6 months ago
5.9.0-beta.1 ... 7 months ago
5.9.0-beta.0 ... 7 months ago
5.8.2 ... 8 months ago
5.8.1 ... 8 months ago
5.8.0 ... 8 months ago
5.7.0 ... 8 months ago
5.6.1 ... 9 months ago
5.6.0 ... 9 months ago
5.5.6 ... 10 months ago
5.5.5 ... 10 months ago
5.1.1 ... 10 months ago
5.1.0 ... a year ago
5.0.1 ... a year ago
5.0.0 ... a year ago
5.0.0-next.7 ... a year ago
5.0.0-next.6 ... a year ago
5.0.0-next.5 ... a year ago
1.0.7 ... 2 years ago
2.0.0-next.2 ... 2 years ago
2.0.0-next.1 ... 2 years ago
1.0.6 ... 3 years ago
1.0.5 ... 3 years ago
1.0.4 ... 4 years ago
1.0.3 ... 4 years ago