With the release of lunr.js 2.0, lunr removed the ability to update existing indexes with new data. While the space benefits of this change are nice, some users need the flexibility of updating their indexes with new data. That's what this library is for.
A simple search index can be created with the familiar lunr
syntax; just substitute lunr-mutable
for lunr
.
var lunrMutable = require('lunr-mutable-indexes');
var index = lunrMutable(function () {
this.field('title')
this.field('body')
this.add({
"title": "Twelfth-Night",
"body": "If music be the food of love, play on: Give me excess of it…",
"author": "William Shakespeare",
"id": "1"
})
})
Now, with a mutable index, we can add...
index.add({
"title": "Merchant of Venice",
"body": "You speak an infinite deal of nothing.",
"author": "William Shakespeare",
"id": "2"
});
Remove...
index.remove({ id: "1" });
Or update existing documents.
index.update({
"body": "With mirth and laughter let old wrinkles come.",
"id": "2"
});
Index serialization also works, with the Index namespace accessible through the lunr-mutable-indexes
object.
// Serialize an index:
var serialized = JSON.stringify(index);
// ...and deserialize it later:
var sameIndex = lunrMutable.Index.load(JSON.parse(serialized));
The main tradeoffs with lunr-mutable-index
were originally discussed in this PR in lunr
.
Work is ongoing to make improvements with these potential drawbacks, but please feel free to contribute fixes!
I wrote a simple extension to lunr.js - I would like to thank the following people for helping to make my life easier: