How do I highlight fuzzy matches in a React component?

Use the `pre` and `post` options in `fuzzy.filter()` to wrap matches with HTML tags or React elements. For example, set `pre: ' '` and `post: ' '`, then render the resulting string safely in JSX using `dangerouslySetInnerHTML` or a sanitizer.

Fuzzy vs Fuse.js: which should I use?

Fuzzy is lighter (1KB vs 10KB) and simpler, ideal for basic fuzzy search. Fuse.js offers more features like weighted search and better large-set performance. Choose Fuzzy for minimalism in small projects, Fuse.js for advanced needs in production apps.

Can fuzzy search handle arrays with thousands of items?

Yes, but synchronously, which may cause UI lag. For large datasets, implement debouncing or move filtering to a web worker manually, as the library lacks built-in async support, per the TODO on async batch updates.

How to implement fuzzy search in a dropdown or autocomplete?

Attach `fuzzy.filter()` to the input's onChange event, passing the query and list. Update dropdown options with the results, optionally highlighting matches using the wrap feature for visual feedback, as shown in the Disney example.

Does fuzzy support non-Latin characters like Chinese or Arabic?

It works on Unicode strings, but the scoring algorithm is designed for Latin scripts. Accuracy might degrade with complex characters, and there's no specific localization support or testing mentioned in the documentation.

Is the fuzzy library still maintained?

The last release was v0.1.3 in October 2016, and the TODO list has unresolved items like better match selection. It's stable but not actively developed, so for long-term projects, consider more updated alternatives.

Open-Awesome

fuzzy

MITJavaScript

A lightweight JavaScript library for fuzzy string searching and filtering, inspired by Sublime Text's command-p.

GitHub

836 stars86 forks0 contributors

What is fuzzy?

Fuzzy is a JavaScript library that implements fuzzy string searching and filtering, allowing users to find items in a list even when their search query contains typos, omissions, or is incomplete. It provides functions to filter arrays and match patterns with configurable options for highlighting matches. The library is inspired by Sublime Text's command-p fuzzy file search and works in both Node.js and browser environments.

Target Audience

JavaScript developers building applications with search functionality, such as autocomplete components, command palettes, or data filtering interfaces, who need a lightweight, dependency-free solution.

Value Proposition

Developers choose Fuzzy for its minimal footprint (around 1KB), ease of integration, and reliable performance. It offers a straightforward API that handles complex matching scenarios without requiring additional dependencies, making it ideal for projects where bundle size and simplicity are priorities.

Overview

Filters a list based on a fuzzy string search

Use Cases

Best For

Adding fuzzy search to autocomplete or typeahead components
Implementing command palettes in web applications
Filtering large lists of data with partial or mistyped queries
Building search interfaces that mimic Sublime Text's file search
Creating interactive examples or demos that require client-side filtering
Enhancing data tables or dropdowns with intelligent search capabilities

Not Ideal For

Applications processing very large datasets that require non-blocking, asynchronous search to maintain UI responsiveness
Projects needing sophisticated matching across multiple fields per item, such as searching both title and description simultaneously
Teams looking for an actively maintained library with frequent updates and community support, given its last release was in 2016

Pros & Cons

Pros

Minimal Bundle Size

At only 1KB with no dependencies, it's trivial to add to any project without impacting load times, as emphasized in the README's standalone claim.

Cross-Environment Consistency

Works identically in Node.js and browsers with provided examples, ensuring seamless integration across platforms without extra configuration.

Customizable Highlighting

Allows wrapping matched characters with user-defined pre/post tags, enabling easy UI integration for search results, as shown in the Jedi example.

Object Property Extraction

Supports a custom extract function to search nested object properties, demonstrated in the Jedi Master example for flexible data handling.

Cons

First-Match Limitation

The algorithm matches the first occurrence in a string rather than the best possible match, leading to suboptimal results, as admitted in the TODO list.

Synchronous Performance Hit

Lacks async processing or web worker support, so filtering large arrays can block the main thread, a known limitation highlighted in the TODO for huge sets.

Dormant Maintenance

With the last release in 2016 and several unfinished TODOs, the library may not receive updates for modern JavaScript features or bug fixes.

Frequently Asked Questions

Related Projects

flexsearch

Next-generation full-text search library for Browser and Node.js

Stars13,730

Forks525

Last commit23 days ago

minisearch

Tiny and powerful JavaScript full-text search engine for browser and Node

Stars6,006

Forks164

Last commit9 months ago

tinysearch

🔍 Tiny, full-text search engine for static websites built with Rust and Wasm

Stars2,942

Forks93

Last commit4 months ago

fuzzysearch

:crystal_ball: Tiny and blazing-fast fuzzy search in JavaScript

Stars2,745

Forks84

Last commit3 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub