6.0.1 • Published 3 years ago

haystack-search v6.0.1

Weekly downloads
2
License
MIT
Repository
github
Last release
3 years ago

Haystack

npm npm

Overview

Haystack is a lightweight search / suggestion library that can be used to find similar matches to a word. Just provide the source data to search against (as an array or object), and Haystack will return a list of approximate matches. The lower the flexibility the more strict your matches will be.

Installation

Using npm:

npm i haystack-search

Import Haystack into your project:

import Haystack from 'haystack-search';
// or
const Haystack = require('haystack-search');
const haystack = new Haystack(options);

Options

OptionDefaultDescription
flexibility (number)2"Fuzziness" of search. The lower the number, the more strict your matches will be. (If set to 0, Haystack will only look for perfect matches)
caseSensitive (boolean)falseWhether or not search is case sensitive
exclusions (array)[]An array of strings or regexes to ignore in query
ignoreStopWords (boolean)falseIgnore common stop words such as the, a, in, etc.
stemming (boolean)falseReduces tokens in a query to their base words using stemmer

Methods

haystack.search(searchTerm, source, [limit]);

Returns an array of matches within your flexibility range. If no limit is given, the default number of results will be 1.

haystack.tokenize(searchTerm, [delimiter]);

Returns an array of tokens. By default this splits on whitespaces, but you can define a custom delimiter to use instead.

Contributions

Contributions and suggestions for improvement are always welcome!

  1. Fork this repo (https://github.com/AlexanderLyon/Haystack/fork)
  2. Create your new feature branch
  3. Commit changes and push
  4. Create a new Pull Request

License

MIT

6.0.1

3 years ago

6.0.0

3 years ago

5.0.0

4 years ago

4.4.41

5 years ago

4.4.4

5 years ago

4.4.3

5 years ago

4.4.2

5 years ago

4.4.1

5 years ago

4.4.0

5 years ago

4.3.41

5 years ago

4.3.4

5 years ago

4.3.3

6 years ago

4.3.2

6 years ago

4.3.1

6 years ago

4.3.0

6 years ago

4.2.0

6 years ago

4.1.0

6 years ago

4.0.2

6 years ago

4.0.1

6 years ago

4.0.0

6 years ago