useMouseLeave

React hook to reliably run an effect on mouseleave

But why?

mouseleave is about as reliable as rain in the Sahara.

A guy even went so far as using jQuery inside React to have a resemblance of predictability. Imagine that.

Introducing, useMouseLeave.

useMouseLeave is the easiest way to fire effects reliably when the mouse leaves (mouseleave is the name of the native event) an element. Also similar to mouseout, but there probably isn't a need for a useMouseOut hook.

How to use it

Installation

npm install use-mouse-leave --save
~ or ~
yarn add use-mouse-leave

Usage

At the top of your file:

import useMouseLeave from 'use-mouse-leave';

Then in your component function:

[...]

const [mouseLeft, ref] = useMouseLeave();

useEffect(() => {
  if (mouseLeft) {
    // The mouse has just left our element, time to
    // run whatever it was we wanted to run on mouseleave:
    // ...
  }
}, [mouseLeft]);

[...]

return (
  <div ref={ref}>
    ...
  </div>
);

Demo

[TODO publish codesandbox]

How it works

The hook attaches a mouseenter listener (which is reliable) to our element. This listener in turn attaches a mousemove listener to the window object (throttled to 50ms for extra bonus sparkly performance ✨🦄), and constantly checks whether the pointer is still within the element's box or not. Then removes the window listener when mouseleave is detected, to save resources. That's it.

Please note

The hook uses getClientBoundingRect() to determine the boundaries of the element. This means that if the element has children positioned relatively, absolutely or fixedly they will not be taken into account (as they do not influence the element's box). Same goes with children with applied transforms.

On the other hand, the browser takes those children into account. Play around with the demo to see when we fire mouseleave and when the browser does.

Tests

One day I'll write fancy Cypress tests (probably something like this), for the moment just know that I've personally, tirelessly and manually stress-tested it using the above sandbox on Chrome, Firefox, Safari and Edge. Do test it in your own project though: mouse events are weird.

Credits

Heavily inspired by @mrdanimal's implementation using lifecycle methods.