RediSearchFuzzy

Simple Node Interface for RediSearch indexes. Implemented for RediSearch 2.x

Description

This library was created as an interface for RediSearch 2+ version for Nodejs. It provides a simple Node API to create, remove and interact with RediSearch's Secondary Indexing. It also provides an additional functionality for Searching with Fuzzy strings. This library uses Promises and therefore supports ES6 async implementation over callbacks.

Please note, that this library does not contain ALL of RediSearch features and thus contributions are welcome.

Installation

1npm install redisearchfuzzy

Getting started

Initiating the RediSearchFuzzy Client and passing existing Redis Client to it:

1const myRedisClient = require("redis").createClient();
2const { RediSearchFuzzy } = require("redisearchfuzzy");
3const RedisFuzzy = new RediSearchFuzzy(myRedisClient);

Now we can call the functions from RedisFuzzy instance.

1const INDEX_NAME = "PRODUCTS";
2
3RedisFuzzy.createIndexList({
4    indexName: INDEX_NAME,
5    schema: [{ field: "title" }, { field: "body" }],
6    options: ["PAYLOAD_FIELD", "myPayload"],
7});
8
9RedisFuzzy.addDocument("product:1", {
10    title: "My favorite zebra",
11    body: "A zebra's dazzling stripes make them among the most recognisable mammals",
12    myPayload: `{ data: "hello1" }`,
13});
14
15RedisFuzzy.addDocument("product:2", {
16    title: "My favorite snake cobra",
17    body: "Venomous and many are capable of rearing upwards and producing a hood when threatened",
18    myPayload: `{ data: "hello2" }`,
19});
20
21// Search in our index:
22const searchIndex = async () => {
23    // with Fuzzy option
24    const resultFuzzy = await Fuzzy.searchDocuments({ indexName: INDEX_NAME, query: "Venom", useFuzzy: true });
25    // without Fuzzy option
26    const result = await Fuzzy.searchDocuments({ indexName: INDEX_NAME, query: "Venom" });
27};
28
29searchIndex();

API

RediSearchFuzzy instance contains: