Fuzzysort is a fast, tiny fuzzy search library for JavaScript, designed to behave like SublimeText-style matching and sorting. It helps you search and filter lists of strings or object fields (via key(s)) and returns scored results with helpers like per-result highlighting, useful for building responsive in-browser or Node-based search.
Project status
- Actively maintained, with very recent work in August 2026 (last upstream push 2026-08-13, and updates v4.0.0 on 2026-08-09, v4.0.1 on 2026-08-10, v4.0.2 on 2026-08-13).
- Update cadence appears fast for the latest cycle, roughly daily between v4.0.0, v4.0.1, and v4.0.2, suggesting ongoing iteration rather than a dormant period.
AI summary generated
Recent updates
v4.0.2
Release v4.0.2 updates fuzzysort query normalization logic and snapshot search behavior around compatibility characters that remap to whitespace. It also adds regression tests to ensure normalized-whitespace queries do not cause recursion/stack overflow and that snapshot candidate narrowing does not incorrectly hide results.
v4.0.1
Version v4.0.1 updates the published package entry points and TypeScript declarations, along with a small runtime change around target preparation. It also introduces additional tests to verify both ES module and CommonJS consumers, and adds coverage for calling prepare() with already-prepared targets and snapshots.
BreakingFeaturesv4.0.0
v4.0.0 makes fuzzysort a much more type-driven API, with new concepts for prepared targets and snapshotting datasets. The code diff also indicates a major packaging change (ES module export structure) and multiple behavior changes around scoring, defaults, and error handling, but the release notes are empty so none of this is documented.
BreakingFeaturesv3.1.0
This release (v3.1.0) introduces preprocessing to make fuzzy matching more tolerant of diacritics and accents for Latin-script text. The code change normalizes and strips combining marks during search preparation, and the test suite and demo page were updated accordingly.
BreakingFeaturesv3.0.2
v3.0.2 primarily updates documentation and the CDN example version. The code changes are small but include a behavior fix around what gets stored in each match result's `obj` field when using `options.all` together with `key` or `keys`.
v3.0.1
Release v3.0.1 was published on 2024-05-16, but no release notes were provided by the publisher. As a result, there is no documented information about new features, fixes, breaking changes, security updates, or dependency changes for this version.
v3.0.0
No release notes were provided for v3.0.0, but the code diff shows a major v2.0.4 to v3.0.0 refactor. The most impactful changes are around the public API shape (TypeScript types and result object API) and the scoring model, which affects thresholds, sorting expectations, and highlight/index extraction usage.
v2.0.4
v2.0.4 updates the published build (UMD and minified bundle) and adjusts the core fuzzysort scoring algorithm. There are no release notes provided, so behavior changes must be inferred from the diff, including changes that can affect result ranking and scoring when searches contain spaces.
Breakingv2.0.1
Release v2.0.1 contains no documented release notes. The code diff is small but it changes the shape of the objects returned by the fuzzy match API, which can break existing integrations that expect a public `indexes` field.
v2.0.0
v2.0.0 is a major refactor of fuzzysort’s public API surface, with corresponding TypeScript definition changes and a new minified browser build. The release notes provided by the publisher are empty, so the changes below are derived from the actual diff (not from documented release notes).
v1.9.0
v1.9.0 makes substantial internal changes to matching and result generation, adds a new option for empty searches, and deprecates older APIs and options. The published release notes were not provided (none included), so several behavior and API surface changes present in the code diff are effectively undocumented from the perspective of release-notes consumers.
BreakingFeaturesv1.2.1
Release v1.2.1 contains a small set of internal changes plus some repository/test tooling updates, but no release notes were provided. The most notable code change is in the cache setup inside fuzzysort.js, where the Map polyfill logic was altered.
v1.2.0
Release v1.2.0 was published on 2022-02-12. No release notes or change details were provided by the publisher, so upgrade impact cannot be determined from the available information.