🎉 Try the public beta of the new docs site at algolia.com/doc-beta! 🎉
Guides / Building Search UI / Going further

Conditional requests with InstantSearch Android

By default, InstantSearch sends an initial request to Algolia’s servers with an empty query. This connection helps speed up later requests.

However, sometimes you don’t want to perform more network calls than are necessary. For example, you may want to limit the number of search requests and reduce your overall Algolia usage. This guide helps you build a UI that prevents this initial request.

Set Searcher triggerSearchFor property

All the Searcher implementations such as HitsSearcher and FacetSearcher provide the triggerSearchFor closure which defines the boolean condition for triggering a search operation. By default has a null value so the search will be triggered on each search() function call.

  • HitsSearcher
    1
    2
    3
    4
    5
    
    val searcher = HitsSearcher(
      client = client, 
      indexName = indexName, 
      triggerSearchFor = { query -> query.query?.startsWith("a") == true }
    )
    
    1
    2
    3
    4
    5
    
    val searcher = HitsSearcher(
      client = client, 
      indexName = indexName, 
      triggerSearchFor = SearchForQuery.lengthAtLeast(1)  // not empty query
    )
    
  • FacetsSearcher
    1
    2
    3
    4
    5
    6
    
    val searcherForFacet = FacetsSearcher(
      client = client, 
      indexName = indexName, 
      attribute = categories,
      triggerSearchFor = { query, attribute, facetQuery -> facetQuery?.startsWith("a") == true }
    )
    
    1
    2
    3
    4
    5
    6
    
    val searcherForFacet = FacetsSearcher(
      client = client, 
      indexName = indexName, 
      attribute = attribute,
      triggerSearchFor = SearchForFacetQuery.lengthAtLeast(1) // not empty query
    )
    
  • MultiSearcher
    1
    2
    3
    4
    
    val searcher = multiSearcher.addHitsSearcher(
      indexName = indexName, 
      triggerSearchFor = SearchForQuery.lengthAtLeast(1)
    )
    
    1
    2
    3
    4
    5
    
    val searcher = multiSearcher.addHitsSearcher(
      indexName = indexName,
      attribute = attribute,
      triggerSearchFor = SearchForFacetQuery.lengthAtLeast(1) 
    )
    
Did you find this page helpful?