❔How to debounce Algolia's Search

April 29, 2020 - 3 min read 🍵🍵

Tags: webdevreactjavascript

Now that I have Algolia’s search feature installed, I have been enjoying their instantly fast searches on my blog. In Algolia’s InstantSearch, each keystroke fires a function to query for a search.

However, this type of effect can be costly to performance. In addition, I also want to stay within their free monthly queries per second threshold and since each keystroke counts as one query, the operations quickly add up.

Luckily, there’s a solution! I’m thankful to be surrounded by great friends who are experienced programmers, giving me the ability to learn, grow and evolve in my programming journey.

They guided me into looking at something called debouncing and I successfully implemented a debouncing feature for my Algolia search results to improve performance and limit the number of search requests.

What exactly is JavaScript debouncing?

A technique to improve browser performance by reducing the number of times a function is called.

Why is it important?

It is important because when you have multiple function calls that happen frequently, it will greatly affect the performance of the browser.

JavaScript is a single threaded language and since the browser can only make so many requests, you’ll run into congestion with function calls. Therefore, implementing debouncing is important. For my case, it helps me throttle my queries per second as I have it set up to fire after a certain interval.

How I installed it on my blog

I followed their documentation here.

I created a DebouncingSearchBox component by utilizing their connectSearchBox connector which is a higher-order component that allows you to encapsulate the logic for their widgets.

//in src/util/DebouncedSearchBox.js
import React, { Component } from 'react';

export default class SearchBox extends Component {
	timerId = null;

	state = {
			value: this.props.currentRefinement

	onChangeDebounced = event => {
			const { refine, delay } = this.props;
			const value = event.currentTarget.value;

			this.timerId = setTimeout(() => refine(value), delay);

			this.setState(() => ({

	render() {
	const { value } = this.state;
		return (
			<div className="ais-SearchBox">
				<form className="ais-SearchBox-form" role="search">
						placeholder="Search here..."
			</div >

Inside this component I added back the original styles that the regular SearchBox had because I am currently overriding the CSS manually.

Next, I imported where I wanted the new search box and deleted the SearchBox from the react-instantsearch-dom since I won’t be using it anymore. Then I passed in a delay prop of 400 milliseconds and viola! A debounced version of Aloglia’s search.

import SearchBox from '../utils/DebouncedSearchBox'

import {
} from "react-instantsearch-dom

const DebouncedSearchBox = connectSearchBox(SearchBox);

const Hit = ({ hit }) => <SearchPreview hit={hit} />

return (
	<Layout location={this.props.location} title={siteTitle}>
		<SEO title="A blog by Kien" />
		<Bio />

		<InstantSearch searchClient={searchClient} indexName="Blog">
			<DebouncedSearchBox delay={400} />
			//<SearchBox> Removed
				<Hits hitComponent={Hit} />

As a bonus, I went ahead and found out exactly how debouncing implemented in JavaScript, this is what a debouncing function looks like:

function debounce(fn, time) {
	let setTimeoutId;

	return function() {
		setTimeoutId = setTimeout(() => {
				fn.apply(this, arguments)
				setTimeoutId = null
		}, time)

© 2023, Built with ❤ and created with Gatsby