uttori-search-provider-lunr v2.1.1

Uttori Search Provider - Lunr

Uttori Search Provider powered by Lunr.js.

Install

npm install --save uttori-search-provider-lunr

API Reference

SearchProvider

Uttori Search Provider powered by Lunr.js.

Kind: global class
Properties

• SearchProvider
  • new SearchProvider([config])
  • .setup([config])
  • .search(query, [limit]) ⇒ Array.<Object>
  • .internalSearch(query, [limit]) ⇒ Array.<Object> ℗
  • .indexAdd([documents])
  • .indexUpdate([documents])
  • .indexRemove([documents])
  • .updateTermCount(query)
  • .getPopularSearchTerms([limit]) ⇒ Array.<string>
  • .shouldAugment([query], [fields]) ⇒ boolean

new SearchProvider(config)

Creates an instance of SearchProvider.

Example (Init SearchProvider)

const searchProvider = new SearchProvider();
const searchProvider = new SearchProvider({ lunr_locales: ['de', 'fr', 'jp'] });

searchProvider.setup(config)

Setup the search provider by building an index of documents.

Kind: instance method of SearchProvider

Example

searchProvider.setup({ documents: [{ slug: 'intro', title: 'Intro', content: '...', tags: ['intro'] }] });

searchProvider.search(query, limit) ⇒ Array.<Object>

External method for searching documents matching the provided query and updates the count for the query used. Uses the internalSearch method internally.

Kind: instance method of SearchProvider
Returns: Array.<Object> - - Returns an array of search results no longer than limit.

Example

searchProvider.search('matching');
➜ [{ ref: 'first-matching-document', ... }, { ref: 'another-matching-document', ... }, ...]

searchProvider.internalSearch(query, limit) ⇒ Array.<Object> ℗

Searches for documents matching the provided query with Lunr.

Kind: instance method of SearchProvider
Returns: Array.<Object> - - Returns an array of search results no longer than limit.
Access: private

searchProvider.indexAdd(documents)

Unused: Adds documents to the index.

Kind: instance method of SearchProvider

searchProvider.indexUpdate(documents)

Unused: Updates documents in the index.

Kind: instance method of SearchProvider

searchProvider.indexRemove(documents)

Unused: Removes documents from the index.

Kind: instance method of SearchProvider

searchProvider.updateTermCount(query)

Updates the search query in the query counts.

Kind: instance method of SearchProvider

searchProvider.getPopularSearchTerms(limit) ⇒ Array.<string>

Returns the most popular search terms.

Kind: instance method of SearchProvider
Returns: Array.<string> - - Returns an array of search results no longer than limit.

Example

searchProvider.getPopularSearchTerms();
➜ ['popular', 'cool', 'helpful']

searchProvider.shouldAugment(query, fields) ⇒ boolean

Determines if a given search query needs to have fields augmented.

Kind: instance method of SearchProvider
Returns: boolean - - Returns true. Lunr does not return all of the required fields for displaing search results.

Tests

To run the test suite, first install the dependencies, then run npm test:

npm install
npm test
DEBUG=Uttori* npm test

Contributors

• Matthew Callis

License

• MIT