feathers-nedb-fuzzy-search

1.5.0 • Public • Published

npm version

feathers-nedb-fuzzy-search

Add fuzzy $search to NeDB service.find queries.

Install

npm install feathers-nedb-fuzzy-search

Usage

Basic usage:
const search = require('feathers-nedb-fuzzy-search')
const messages = app.service('messages')

// Enable for message service, may use app.hooks too.
messages.hooks({
  before: {
    // Pass an array of fields to be included in fuzzy search.
    find: search(['name', 'email'])
  }
})

// Search a particular field.
let res = await service.find({ query: { name: { $search: 'ello' } } })
// Search all fields.
let res = await service.find({ query: $search: 'ello' } })

Besure to whitelist non-standard query parameters in your model. That's ['$text', '$regex'] for MongoDB , and ['$where', '$regex'] for NeDB.

Options

Instead of passing an array, you may pass an object containing both the desired fields and a few options depending on the mode being used.

In NeDB $where mode:

search({
  fields: ['search.this.path', 'this.path.too', 'title'],
  deep: true,
  fuzzyDiacritics: false
})
  • fields - Specify which fields to search.
  • deep- If true and fields is undefined, will search deep in objects.
  • fuzzyDiacritics- If true, diacritics will be ignored. 5x slower.

In NeDB $regex mode it takes as service options the following:

  • excludeFields - Specify which fields to exclude from search.
  • fields - Specify which fields to search. Mutually exclusive.

As query parameters it also takes $caseSensitive

Complete example

const feathers = require('feathers')
const hooks = require('feathers-hooks')
const NeDB = require('nedb')
const service = require('feathers-nedb')
const search = require('feathers-nedb-fuzzy-search')

const Model = new NeDB({
  filename: './example.db',
  autoload: true
})

const app = feathers()
app.configure(hooks())
app.use('/test', service({ Model }))
app.hooks({
  before: {
    find: search({
      // if omitted, then it will search all properties of documents
      fields: ['title', 'description']
    })
  }
})

// you need node v7 or above for async / await syntax
async function testDatabase () {
  let service = app.service('test')
  await service.create([
    { 'title': 'asdf' },
    { 'title': 'qwerty' },
    { 'title': 'zxcvb' },
    { 'title': 'hello world' },
    { 'title': 'world around' },
    { 'title': 'cats are awesome' },
  ])

  let res = await service.find({ query: { $search: 'world' } })
  let res = await service.find({ query: { title: { $search: 'ello' } } })

  console.log(res)
  // [ { title: 'world around', _id: '1RDM5BJWX4DWr1Jg' },
  //   { title: 'hello world', _id: 'dX4bpdM1IsAFkAZd' } ]
  //   { title: 'hello world', _id: 'dX4bpdM1IsAFkAZd' } ]
}

testDatabase()
  .catch(e => console.error(e))

Plans for 2.0

  • Support MongoDB and NeDB in this adapter
  • Implement global search with $regex, instead of $where and $text which have wildly different behavior
  • Implement a $searchOpts parameter with {$native, $caseSensitive} etc
  • Keep the same name, NeDB is the biggest raison d'etre
    • Though it's not a bad option to simplify MongoDB search queries

Development

npm test  # runs mocha, see test.js

License

MIT © 2019 Ray Foss MIT © 2017 Arve Seljebu

Versions

Current Tags

  • Version
    Downloads (Last 7 Days)
    • Tag
  • 1.5.0
    1
    • latest

Version History

Package Sidebar

Install

npm i feathers-nedb-fuzzy-search

Weekly Downloads

4

Version

1.5.0

License

MIT

Unpacked Size

2.45 MB

Total Files

14

Last publish

Collaborators

  • arve0
  • rayfoss