Fuse.js

Fuse.js

Lightweight fuzzy-search library, with zero dependencies.

Sponsors

Quick Example

import Fuse from 'fuse.js'

const books = [
  { title: "Old Man's War", author: 'John Scalzi' },
  { title: 'The Lock Artist', author: 'Steve Hamilton' },
  { title: 'JavaScript Patterns', author: 'Stoyan Stefanov' }
]

const fuse = new Fuse(books, {
  keys: ['title', 'author'],
  includeScore: true
})

fuse.search('jon')
// [{ item: { title: "Old Man's War", author: "John Scalzi" }, refIndex: 0, score: 0.25 }]

fuse.search('patterns')
// [{ item: { title: "JavaScript Patterns", ... }, refIndex: 2, score: 0.0 }]

Features

  • Fuzzy search — typo-tolerant matching powered by the Bitap algorithm
  • Token search — split multi-word queries into terms, fuzzy-match each, rank with IDF
  • Extended search — operators for exact, prefix, suffix, inverse, and include matching
  • Logical search — $and / $or expressions for structured queries
  • Weighted keys — boost fields like title over description
  • Nested search — dot notation, array notation, or custom getFn
  • Zero dependencies — works in the browser, Node.js, and Deno
  • Two builds — full (~8 kB gzip) or basic (~6.5 kB gzip)

Get Started

npm install fuse.js

See Getting Started for installation options, builds, and imports.

Try the live demo →

Last Updated: