Skip to content

A tool for searching elements in JavaScript arrays

License

Notifications You must be signed in to change notification settings

freearhey/search-js

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

search-js

A tool for searching elements in JavaScript arrays.

Installation

npm install @freearhey/search-js

Usage

const sj = require('@freearhey/search-js')

const data = [
  { name: 'Nikita', age: 24 },
  { name: 'Jeremy', age: 13 },
  { name: 'Jerry', age: 18 },
  { name: 'Gwendolyn', age: 43 }
]

const index = sj.createIndex(data)

const results = index.search('Jer')

console.log(results)

Output:

[
  { name: 'Jeremy', age: 13 },
  { name: 'Jerry', age: 18 },
]

Search syntax:

Example Description
cat Finds items that have "cat" in their descriptions
cat dog Finds items that have "cat" AND "dog" in their descriptions
cat,dog Finds items that have "cat" OR "dog" in their descriptions
bio:"electric tape" Finds items that have "electric tape" in the bio
email:. Finds items that have an email
stars:>4 Finds items with more than 5 stars
stars:<2 Finds items with less than 2 stars

Options:

Name Type Description
searchable Array List of searchable attributes. By default, all attributes will be searched.

Example:

index.search('t', { searchable: ['lastName'] })

Testing

npm test

Linting

npm run lint

Contribution

If you find a bug or want to contribute to the code or documentation, you can help by submitting an issue or a pull request.

License

MIT

About

A tool for searching elements in JavaScript arrays

Resources

License

Stars

Watchers

Forks

Packages

No packages published