Don't miss this free $200 USD credit (Only valid for 60 days) on DO, launch your idea now

You have no excuses now, use this free credit to launch your projects now on Digital Ocean.

Table of contents

Debounce and Throttle in Javascript

Debounce and Throttle in Javascript

Debounce and throttle are design patterns used to limit the execution of functions, generally they are used to restrict the amount of times an event is fired: click, scroll, resize or other events. Patterns are not exclusive to Javascript; in a previous post I explained how to use throttle to limit the number of requests received by the nginx server .

Both patterns generate a function that receives a callback and a timeout or delay.

Debounce vs Throttle differences

If you’re in a rush, these are the main differences and applications for both patterns. However, if you want to understand them deeply keep reading.

Aspect Debounce Throttle
Definition Executes the function after a specified delay from the last time the event was triggered. Executes the function at regular intervals, ensuring it is called no more than once per period.
Timing of Execution Delayed until the event stops firing for a certain period. Executes immediately or at fixed intervals, regardless of how frequently the event occurs.
Use Case Example Search input field: updating suggestions only after the user stops typing for a moment. Scroll events: limiting the rate at which a scroll position is calculated.

Debounce Pattern

The debounce pattern postpones the execution of a function until a certain waiting time has elapsed.

Further attempts to execute the function will cancel the pending execution and restart the timeout.

Simplified debounce pattern schematic

Debounce pattern explanation

The code for debounce in javascript looks like this:

const debounce = (callback, waitTimeInMs) => {
  let timeout 
  return (...args) => {
    clearTimeout(timeout)
    timeout = setTimeout(()=> callback(...args), waitTimeInMs)
  }
}

Our debounce function returns a function, which will receive any number of arguments (…args).

This function uses a closure to access the variable timeout. What is timeout? timeout is a setTimeout function, which schedules the execution of our callback for later execution.

But now pay attention to the clearTimeout. Every time we call the debounce function it will clear any scheduled function, so the only way for our callback to run is to wait for the time we passed as an argument.

Throttling pattern

The throttling pattern sets a waiting time during which no more functions can be called again. Unlike the bounce pattern, the timeout is not reset if we try to call the function again.

Simplified diagram of the throttling pattern

Explanation of throttling pattern

The code for throttling in javascript looks like this.

const throttling = (callback, delay) => {
  let timeout
  return (...args) => {
    if (timeout !== undefined) {
      return
    }

    timeout = setTimeout(() => {
      timeout = undefined
    }, delay)

    return callback(...args)
  }
}

The throttling function returns a function that will have two sides depending on the timeout status:

  • timeout is defined: this means that a function is already scheduled for execution, in this case the function does nothing, i.e. it blocks the execution of new functions by means of an empty return.
  • timeout is not defined: if timeout is not defined, we create a setTimeout and assign it to the timeout variable. This function, once its execution time has elapsed, will remove itself from the timeout variable. Subsequently, and to finish, we execute the callback function.

Other resources on debounce and throttling

Eduardo Zepeda
Web developer and GNU/Linux enthusiast. I believe in choosing the right tool for the job and that simplicity is the ultimate sophistication. Better done than perfect. I also believe in the goodness of cryptocurrencies outside of monetary speculation.
Read more