fuzzysearch

Tiny and blazing-fast fuzzy search in JavaScript

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
fuzzysearch
2,68361.0.38 years ago8 years agoMinified + gzip package size for fuzzysearch in KB

Readme

fuzzysearch
Tiny and blazing-fast fuzzy search in JavaScript

Fuzzy searching allows for flexibly matching a string with partial input, useful for filtering data very quickly based on lightweight user input.
Demo
To see fuzzysearch in action, head over to bevacqua.github.io/horsey3, which is a demo of an autocomplete component that uses fuzzysearch to filter out results based on user input.
Install
From npm
npm install --save fuzzysearch
fuzzysearch(needle, haystack)
Returns true if needle matches haystack using a fuzzy-searching algorithm. Note that this program doesn't implement levenshtein distance2, but rather a simplified version where there's no approximation. The method will return true only if each character in the needle can be found in the haystack and occurs after the preceding character.
fuzzysearch('twl', 'cartwheel') // <- true
fuzzysearch('cart', 'cartwheel') // <- true
fuzzysearch('cw', 'cartwheel') // <- true
fuzzysearch('ee', 'cartwheel') // <- true
fuzzysearch('art', 'cartwheel') // <- true
fuzzysearch('eeel', 'cartwheel') // <- false
fuzzysearch('dog', 'cartwheel') // <- false

An exciting application for this kind of algorithm is to filter options from an autocomplete menu, check out horsey
3 for an example on how that might look like.
But! RegExps...!
!chart showing abysmal performance for regexp-based implementation1
License
MIT