Introducing react-global-event-listener

Published on October 1st, 2018

Say you have a couple of components in your React application that perform some actions on window scroll events. Adding a bunch of event listeners can be a big performance hit on noisy event dispatchers, like scroll or mousemove, especially if you’re wrapping those listeners with throttle or debounce. Wouldn’t it be nice if we could subscribe to those events from our components and only register an event listener once?


yarn add react-global-event-listener


We’re building a feed with infinite scroll. When we get to the bottom of the page, we want to fetch the next set of items to display. Instead of calling window.addEventListener in componentWillMount, we can subscribe to scroll events on window using the HOC provided by react-global-event-listener:

import React from 'react'
import _ from 'lodash'
import { withGlobalEventListener } from 'react-global-event-listener'

class Feed extends React.Component {
  componentWillMount() {
      {listenerWrapper: _.partialRight(_.throttle, 200)}
  componentWillUnmount() {
  onScroll = () => {
    // load the next items when we reach the bottom of the feed
  render() {
    return (
        { => item.title)}

export default withGlobalEventListener(Feed)

If we wanted to add a button that will only appear when the page is scrolled at least 500 pixels, we can have that component subscribe to the same window scroll event with only one event listener actually being added to window.

Performance Difference

As I mentioned above, the real difference in performance comes when you’re wrapping your listeners with throttle or debounce. The additional overhead of these wrappers justifies the need for this library. I performed a test with 10 event listeners using _.throttle(f, 100) and scrolled gently for 10 seconds.

This is the call tree with the naive implementation:

call tree with addEventListeners

And with react-global-event-listener:

call tree with react-globall-event-listener

There is a ~2x difference overall.

Tagged with

> $ cat tags